واجهة برمجة البيانات المفتوحة

كل ما هو منشور على Tempussit — الدورات ومقالات المدونة والمفاهيم والأسئلة الشائعة — متاح بصيغة JSON للبرامج ومساعدي الذكاء الاصطناعي. للقراءة فقط، دون مفتاح أو تسجيل.

ما المتاح

GET /data/v1/index.json

الفهرس: لغات الموقع وكتالوجات الدورات وروابط جميع ملفات البيانات.

GET /data/v1/courses/{languageKey}.json

دورات لغة واحدة من الكتالوج، 100 في كل صفحة (المعامل ?page=).

GET /data/v1/course/{slug}.json

بطاقة دورة منشورة واحدة: العنوان والوصف والمؤلف واللغات والسعر والبرنامج وعنوان الصفحة والغلاف.

GET /data/v1/{languageCode}/{kind}.json

المفاهيم والأسئلة الشائعة وأقسام المدونة ومقالاتها بلغة واحدة من لغات الموقع.

GET /data/v1/openapi.json

وصف جميع الاستجابات بصيغة OpenAPI 3.1.

أمثلة على الطلبات

curl https://tempussit.com/data/v1/index.json
curl https://tempussit.com/data/v1/courses/ar.json
curl https://tempussit.com/data/v1/course/{slug}.json
curl -I https://tempussit.com/data/v1/ar/faq.json

fetch("https://tempussit.com/data/v1/ar/glossary.json")
  .then(response => response.json());

الشروط

• للقراءة فقط: لا تُقبل إلا طلبات GET وHEAD.
• عدد الطلبات من عنوان IP واحد في الدقيقة محدود. عند تجاوز الحد يكون الرد 429 مع الترويسة Retry-After.
• يمكن تخزين الاستجابات مؤقتًا لمدة 5 دقائق وطلبها من المتصفح على أي موقع (Access-Control-Allow-Origin: *).
• فقط ما يظهر على الصفحات العامة: لا مسودات ولا مشتريات ولا بيانات شخصية.
• الإصدار جزء من العنوان (/data/v1/). العناوين السابقة دون إصدار تواصل العمل.