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

كل ما هو منشور على 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/). العناوين السابقة دون إصدار تواصل العمل.

حُدّث في 9 نوفمبر 2026