في سفاري، كام دوسة بسيطة.
اللي اتغير في الإصدار v1 من الـ API العام، الأحدث الأول. الإضافات متوافقة مع اللي قبلها. أي تغيير بيكسر التوافق هيطلع كإصدار جديد، ومكتوب هنا برقم إصداره.
بتستهلكه برمجيًا؟ GET /api/v1/changelog.json خلاصة Atom
sellerAr بقى موجود دايماً في كل بائع وفي best، وبيبقى null لو البائع ملوش اسم عربي. قبل كده المفتاح كان بيتشال، وده كان بيبوّظ الكلاينتس الصارمة. والمصرف المتحد وبنك أبوظبي الأول (FAB) كانوا خسروا اسمهم العربي بعد ما مصدر غيّر اسمهم، ورجعلهم. والـ OpenAPI spec بقى معلّم كل الحقول required، زي ما الـ feed طول عمره بيبعتها، فأي كلاينت متولّد يقدر يعتبر كل مفتاح موجود دايماً. شكراً لـ ahmedmohamedm-dev على البلاغ./embed/{lang}/{category}/{slug}/{side} في iframe عشان يظهر أحسن سعر النهارده وقراءة اليوم، من غير مفتاح. الكود موجود في صفحة الـ API.sellers بتاعة العملات. بنك القاهرة كان واخد sellerAr غلط (اسم كريدي أجريكول بالعربي)، ودلوقتي بقى بنك القاهرة (BDC). وبنك الإسكندرية وبنك البركة وكريدي أجريكول كانوا ممكن يظهروا مرتين في نفس الأصل باسمين مختلفين، ودلوقتي بيظهروا مرة واحدة. التصليح بيبدأ من التحديث اليومي الجاي. شكراً لـ ahmedmohamedm-dev على البلاغ.series بقى فيه benchBuy وbenchSell (سعر الشراء والبيع الرسمي) وglobal (السعر العالمي في اليوم ده). فالرسم البياني يقدر يقارن أفضل سعر بسعر البنك المركزي والسعر العالمي في نفس الاتجاه، يوم بيوم. وكل واحد بيبقى null في اليوم اللي مفيهوش، والمعادن ملهاش سعر رسمي. bench الاسم القديم لـ benchBuy لسه شغال، بس هيتشال في v2. شكراً لـ ahmedmohamedm-dev على الاقتراح.info.x-status)، علشان الأدوات ووكلاء الذكاء الاصطناعي اللي بيقروا الوصف بس يلاقوا التشغيل وسجل الأعطال لحظة بلحظة.confidence لكل أصل بقى فيه providers: عدد مصادر الأسعار المستقلة اللي غذّته النهارده، رقم بس من غير أسامي. السعر الرسمي والسعر العالمي مش محسوبين. وهو جنب checks اللي بيعدّ المصادر اللي سعّرت نفس الجهة، فالأصل اللي مصادره بتسعّر جهات مختلفة مبقاش يبان كأنه من مصدر واحد.signals.position.lean يبقى null، وده اللي الـ feed بيرجعه وقت ما التقييم لسه بيتظبط (التاريخ قليل على إننا نحدد مكان النهارده). الـ feed نفسه متغيرش. والوصف بقى بيتراجع على الـ feed الحقيقي مع كل نسخة، فمش هيختلفوا عن بعض تاني.buy و sell لكل جهة: buy هو اللي الجهة بتدفعهولك لما تبيع، و sell هو اللي بتدفعه انت لما تشتري. و confidence.checks بقى موصوف باللي بيعدّه فعلًا، أكبر عدد مصادر سعّرت نفس الجهة النهارده. و signals.trend.direction بقى نوعه رقم صحيح زي ما الـ feed بيرجعه من الأول (1 أو 0 أو -1)، ومستوى الثقة في المثال بقى قيمة حقيقية. الـ feed نفسه متغيرش.status.Daily-Limit و Daily-Used و Daily-Reset: الكمية اليومية للاستخدام العادل، وعدد الطلبات اللي عنوانك عملها النهارده، وفاضل كام ثانية لحد ما العداد يتجدد عند منتصف الليل بتوقيت القاهرة. مفيش حاجة بتتوقف لما توصل للكمية اليومية./api/v1 بيعرض كل نقاط الوصول، والفلاتر المتاحة، وحدود الباقة المجانية، فتعرف طريقك في طلب واحد. وكل رد من الفيد دلوقتي كمان فيه لينك _self للطلب اللي طلعه بالظبط.RateLimit-Policy بحصتك الكاملة، علشان تنظّم طلباتك من الأول بدل ما تستنى الـ 429. وتطبيقات المتصفح كمان تقدر تقراه وتبعت هيدر X-Contact الاختياري عبر النطاقات.Deprecation و Sunset مع لينك Link للإصدار الجديد، علشان يوصلك التنبيه جوه الرد ومعاك وقت تنقل فيه. مفيش حاجة متوقفة دلوقتي.minIntervalSeconds اتبدّل بـ recommendedPollSeconds (300، إرشاد بس).?asset= (بالـ slug أو الـ id، مفصولين بفاصلة، وينفع تجمعه مع ?category=).Link بيشاور على المواصفات والتوثيق، وشرح لقيم كل حقل، وقواعد قراية البيع والشرا، ومثال رد كامل.application/problem+json (RFC 9457)، مع الحفاظ على نفس الحقول عشان مفيش حاجة تتكسر.seriesWindowDays). التاريخ الأطول وتاريخ كل جهة محجوز للباقة المدفوعة.ETag وحدود الاستخدام وتستخدم الطلبات الشرطية عبر النطاقات./api/v1/feed.json بيرجّع أحسن جهة مرخصة لكل اتجاه، وتقييم اليوم، والأسعار الرسمية والعالمية، وتاريخ يومي، بلينك بإصدار، وفلترة بالنوع، وطلبات شرطية بـ ETag، ومواصفات OpenAPI منشورة، من غير مفتاح، والـ CORS مفتوح.