صُنّاع القمم

للمطوّرين

واجهة API العامة

واجهة قراءة فقط تعرض المحتوى العام للمنصة. لا تتضمّن أي بيانات طلبة أو معلمين، ولا تتيح أي عملية كتابة. كل الردود JSON بترميز UTF-8.

الاكتشاف الآلي

الواجهات منشورة في كتالوج وفق RFC 9727، ويمكن للوكيل اكتشافها بلا قراءة هذه الصفحة:

curl https://peak-makers.com/.well-known/api-catalog \
  -H "Accept: application/linkset+json"

النقاط المتاحة

  • GET/api/v1/pages.json

    فهرس الصفحات العامة

    قائمة بكل الصفحات المنشورة: المسار، الرابط المطلق، العنوان، والوصف. تُبنى من ملفات HTML نفسها وتستبعد كل صفحة موسومة noindex.

  • GET/api/v1/status.json

    حالة الخدمة

    رد صحي موجز. يتحقق منه كتالوج الواجهات عبر علاقة status.

  • GET/.well-known/api-catalog

    كتالوج الواجهات

    مستند Linkset بصيغة application/linkset+json يصف الواجهات، وفق RFC 9727.

المواصفة

مواصفة OpenAPI 3.1 كاملة متاحة بصيغة JSON:

openapi.jsonpages.jsonapi-catalog

حدود الاستخدام

  • الردود عامة ولا تحتاج مفتاحاً.
  • يُسمح بالتخزين المؤقت؛ الفهرس يتغيّر عند كل نشر فقط.
  • للاستخدام الكثيف، خزّن النسخة عندك بدل الطلب المتكرر.
  • لا تُستخدم الواجهة للكتابة أو للوصول إلى بيانات الطلبة — لا وجود لهذه الوظائف أصلاً.
كتم الصوتوضع ليليشاشة ذكيةأدوات ظاهرة