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/). نشانی‌های پیشین بدون نسخه همچنان کار می‌کنند.