دليلك
English
API

سجل تغييرات الـ API

اللي اتغير في الإصدار v1 من الـ API العام، الأحدث الأول. الإضافات متوافقة مع اللي قبلها. أي تغيير بيكسر التوافق هيطلع كإصدار جديد، ومكتوب هنا برقم إصداره.

بتستهلكه برمجيًا؟ GET /api/v1/changelog.json خلاصة Atom

الإصدار v1 من الـ API #

#

اتصلح
  • 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 على الاقتراح.

#

اتضاف
  • وصف OpenAPI بقى فيه رابط صفحة الحالة العامة (info.x-status)، علشان الأدوات ووكلاء الذكاء الاصطناعي اللي بيقروا الوصف بس يلاقوا التشغيل وسجل الأعطال لحظة بلحظة.
  • confidence لكل أصل بقى فيه providers: عدد مصادر الأسعار المستقلة اللي غذّته النهارده، رقم بس من غير أسامي. السعر الرسمي والسعر العالمي مش محسوبين. وهو جنب checks اللي بيعدّ المصادر اللي سعّرت نفس الجهة، فالأصل اللي مصادره بتسعّر جهات مختلفة مبقاش يبان كأنه من مصدر واحد.
اتصلح
  • وصف OpenAPI بقى بيسمح إن signals.position.lean يبقى null، وده اللي الـ feed بيرجعه وقت ما التقييم لسه بيتظبط (التاريخ قليل على إننا نحدد مكان النهارده). الـ feed نفسه متغيرش. والوصف بقى بيتراجع على الـ feed الحقيقي مع كل نسخة، فمش هيختلفوا عن بعض تاني.
  • وصف OpenAPI بقى بيقول معنى buy و sell لكل جهة: buy هو اللي الجهة بتدفعهولك لما تبيع، و sell هو اللي بتدفعه انت لما تشتري. و confidence.checks بقى موصوف باللي بيعدّه فعلًا، أكبر عدد مصادر سعّرت نفس الجهة النهارده. و signals.trend.direction بقى نوعه رقم صحيح زي ما الـ feed بيرجعه من الأول (1 أو 0 أو -1)، ومستوى الثقة في المثال بقى قيمة حقيقية. الـ feed نفسه متغيرش.

#

اتضاف
  • في صفحة حالة عامة على status.getdaleelak.com بتوري التشغيل وسجل الأعطال لحظة بلحظة للموقع والـ API وتحديث البيانات. بتقيسها أداة مراقبة مستقلة، مش سيرفراتنا. ومستند الاستكشاف بقى فيه رابط status.
  • الردود دلوقتي فيها هيدرز Daily-Limit و Daily-Used و Daily-Reset: الكمية اليومية للاستخدام العادل، وعدد الطلبات اللي عنوانك عملها النهارده، وفاضل كام ثانية لحد ما العداد يتجدد عند منتصف الليل بتوقيت القاهرة. مفيش حاجة بتتوقف لما توصل للكمية اليومية.
  • مستند استكشاف على /api/v1 بيعرض كل نقاط الوصول، والفلاتر المتاحة، وحدود الباقة المجانية، فتعرف طريقك في طلب واحد. وكل رد من الفيد دلوقتي كمان فيه لينك _self للطلب اللي طلعه بالظبط.
  • الردود دلوقتي فيها هيدر RateLimit-Policy بحصتك الكاملة، علشان تنظّم طلباتك من الأول بدل ما تستنى الـ 429. وتطبيقات المتصفح كمان تقدر تقراه وتبعت هيدر X-Contact الاختياري عبر النطاقات.
  • لما أي إصدار من الـ API يتوقف، ردوده هتحمل تواريخ Deprecation و Sunset مع لينك Link للإصدار الجديد، علشان يوصلك التنبيه جوه الرد ومعاك وقت تنقل فيه. مفيش حاجة متوقفة دلوقتي.
اتغير
  • الحدود بقت نموذج واحد واضح: حوالي 1,000 طلب في اليوم هي الكمية المجانية، وحد الدقيقة موجود بس علشان يمنع الدفعات الكبيرة. شرط الـ 20 ثانية بين كل طلب والتاني اتلغى. الأسعار بتتغير مرة كل ساعة تقريبًا بالكتير، فطلب كل 5 دقايق تقريبًا كفاية جدًا. وفي مستند الاستكشاف وجزء الحدود في وصف OpenAPI، minIntervalSeconds اتبدّل بـ recommendedPollSeconds (300، إرشاد بس).

#

اتضاف
  • فلترة الفيد لأصول محددة بـ ?asset= (بالـ slug أو الـ id، مفصولين بفاصلة، وينفع تجمعه مع ?category=).
  • الـ API بقى بيوصّف نفسه للأدوات ووكلاء الذكاء الاصطناعي: هيدر Link بيشاور على المواصفات والتوثيق، وشرح لقيم كل حقل، وقواعد قراية البيع والشرا، ومثال رد كامل.
اتغير
  • الأخطاء دلوقتي بترجع بصيغة application/problem+json (RFC 9457)، مع الحفاظ على نفس الحقول عشان مفيش حاجة تتكسر.
  • الفيد المجاني دلوقتي بيرجّع آخر 30 يوم من التاريخ لكل أصل (شوف seriesWindowDays). التاريخ الأطول وتاريخ كل جهة محجوز للباقة المدفوعة.
اتصلح
  • تطبيقات المتصفح دلوقتي تقدر تقرا هيدر الـ ETag وحدود الاستخدام وتستخدم الطلبات الشرطية عبر النطاقات.

#

اتضاف
  • اتطلق الـ API العام. فيد JSON مجاني على /api/v1/feed.json بيرجّع أحسن جهة مرخصة لكل اتجاه، وتقييم اليوم، والأسعار الرسمية والعالمية، وتاريخ يومي، بلينك بإصدار، وفلترة بالنوع، وطلبات شرطية بـ ETag، ومواصفات OpenAPI منشورة، من غير مفتاح، والـ CORS مفتوح.

افتح مواصفات OpenAPI