# API داده‌های باز

هر آنچه در Tempussit منتشر شده — دوره‌ها، مقاله‌های وبلاگ، مفاهیم و پرسش‌های متداول — به صورت JSON برای برنامه‌ها و دستیارهای هوش مصنوعی در دسترس است. فقط خواندنی، بدون کلید و ثبت‌نام.

## چه چیزی در دسترس است

**`GET /data/v1/index.json`**

فهرست: زبان‌های سایت، کاتالوگ‌های دوره و پیوند همه فایل‌های داده.

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

دوره‌های یک زبان کاتالوگ، ۱۰۰ دوره در هر صفحه (پارامتر ?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/fa.json
curl https://tempussit.com/data/v1/course/{slug}.json
curl -I https://tempussit.com/data/v1/fa/faq.json

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

## شرایط

- فقط خواندنی: تنها درخواست‌های GET و HEAD پذیرفته می‌شوند.
- شمار درخواست‌ها از یک نشانی IP در هر دقیقه محدود است. فراتر از حد، پاسخ 429 با سرآیند Retry-After است.
- پاسخ‌ها را می‌توان ۵ دقیقه در حافظه نهان نگه داشت و از مرورگر در هر سایتی درخواست کرد (Access-Control-Allow-Origin: \*).
- فقط آنچه در صفحه‌های عمومی دیده می‌شود: بدون پیش‌نویس، خرید یا داده شخصی.
- نسخه بخشی از نشانی است (/data/v1/). نشانی‌های پیشین بدون نسخه همچنان کار می‌کنند.

به‌روزرسانی: 2026 نوامبر 9