دليلك
English
API

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

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

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

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

#

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

#

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

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