الاستيثاق
توكن حامل قصير العمر في ترويسة Authorization. كل طلب يُعاد تقييمه: الهوية، المستأجر، النطاق، الإذن، الرؤية، وحالة النسخة.
التوكن الموثّق يحمل: المعرّف، نوع الهوية، مستأجرًا واحدًا، والنطاقات — غياب أيٍّ منها رفض كامل.
GET /v1/me — هوية المستدعي وأدواره وأذوناته في المستأجر الحالي.
النطاقات
النطاق سقف في التوكن. يحصل عميل الخدمة على تقاطع نطاقات التوكن مع النطاقات الممنوحة لحسابه.
| النطاق | المعنى |
|---|---|
| curriculum:read | قراءة المناهج والأطر والصفوف. |
| outcome:read | قراءة النتاجات والمهارات والمعايير. |
| association:read | قراءة علاقات الجراف. |
| alignment:read | قراءة المواءمات ومجموعات الربط. |
| evidence:read | قراءة عبارات الأدلة والتوجيهات. |
| webhook:manage | إدارة اشتراك webhook الخاص بعميلك. |
ملاحظة
لعميل الخدمة خمسة نطاقات قراءة، وwebhook:manage لاشتراكاته في الـ webhooks، بمنح صريح لا افتراضي. أي نطاق آخر يرفضه قيد في قاعدة البيانات.
النقاط
كل مسار أدناه مخدوم فعلًا. النسخة v1 في المسار هي نسخة العقد، لا نسخة المنهج.
| الطريقة | المسار | النطاق | المعنى |
|---|---|---|---|
| GET | /v1/academic-levels | curriculum:read | البيانات المرجعية: كل دول العالم، والمناهج، والمواد، والأنظمة التعليمية وصفوفها، والمستويات الأكاديمية — للمزامنة. |
| GET | /v1/alignments | alignment:read | مجموعات الربط بين المناهج ومواءماتها المعتمدة. |
| GET | /v1/associations | association:read | علاقات الجراف الداخلية للنسخة. |
| GET | /v1/countries | curriculum:read | البيانات المرجعية: كل دول العالم، والمناهج، والمواد، والأنظمة التعليمية وصفوفها، والمستويات الأكاديمية — للمزامنة. |
| GET | /v1/curricula | curriculum:read | سرد المناهج وتفاصيلها مع آخر نسخة منشورة. |
| GET | /v1/curricula/{id} | curriculum:read | سرد المناهج وتفاصيلها مع آخر نسخة منشورة. |
| GET | /v1/curriculum-types | curriculum:read | البيانات المرجعية: كل دول العالم، والمناهج، والمواد، والأنظمة التعليمية وصفوفها، والمستويات الأكاديمية — للمزامنة. |
| GET | /v1/education-systems | curriculum:read | البيانات المرجعية: كل دول العالم، والمناهج، والمواد، والأنظمة التعليمية وصفوفها، والمستويات الأكاديمية — للمزامنة. |
| GET | /v1/education-systems/{id}/grade-levels | curriculum:read | البيانات المرجعية: كل دول العالم، والمناهج، والمواد، والأنظمة التعليمية وصفوفها، والمستويات الأكاديمية — للمزامنة. |
| GET | /v1/evidence | evidence:read | حزمة الأدلة للنتاج: عبارات ومؤشرات وتوجيهات. |
| GET | /v1/framework-domains | curriculum:read | التصنيف: المجالات الكبرى والمجالات والفروع والمعايير. |
| GET | /v1/framework-macros | curriculum:read | التصنيف: المجالات الكبرى والمجالات والفروع والمعايير. |
| GET | /v1/framework-outcomes | outcome:read | نتاجات الإطار وتفاصيلها في إصدار. |
| GET | /v1/framework-outcomes/{id} | outcome:read | نتاجات الإطار وتفاصيلها في إصدار. |
| GET | /v1/framework-standards | curriculum:read | التصنيف: المجالات الكبرى والمجالات والفروع والمعايير. |
| GET | /v1/framework-standards/{id} | curriculum:read | التصنيف: المجالات الكبرى والمجالات والفروع والمعايير. |
| GET | /v1/framework-strands | curriculum:read | التصنيف: المجالات الكبرى والمجالات والفروع والمعايير. |
| GET | /v1/framework-versions | curriculum:read | إصدارات الإطار (MAJOR.MINOR.PATCH). |
| GET | /v1/frameworks | curriculum:read | الأطر العامة وقراءتها بالمعرّف أو الرمز الثابت. |
| GET | /v1/frameworks/applicable | curriculum:read | الأطر الصالحة لكل مادة وصف في نظام تعليمي أو دولة، بقاعدة الحسم الملزمة: المخصص للنظام، ثم للدولة، ثم العام. |
| GET | /v1/frameworks/{id} | curriculum:read | الأطر العامة وقراءتها بالمعرّف أو الرمز الثابت. |
| GET | /v1/grade-levels | curriculum:read | الصفوف الدراسية المرجعية للمنهج (غير مُصدَّرة). |
| GET | /v1/mapping-sets | alignment:read | مجموعات الربط بين المناهج ومواءماتها المعتمدة. |
| GET | /v1/mapping-sets/{id} | alignment:read | مجموعات الربط بين المناهج ومواءماتها المعتمدة. |
| GET | /v1/outcomes | outcome:read | سرد النتاجات وتفاصيلها، مع التثبيت بالنسخة والتوسعة بالمسار. |
| GET | /v1/outcomes/{id} | outcome:read | سرد النتاجات وتفاصيلها، مع التثبيت بالنسخة والتوسعة بالمسار. |
| GET | /v1/sources | source:read:metadata | بيانات المصادر الوصفية فقط — لا محتوى مرجعي. |
| GET | /v1/sources/{id} | source:read:metadata | بيانات المصادر الوصفية فقط — لا محتوى مرجعي. |
| GET | /v1/subject-areas | curriculum:read | البيانات المرجعية: كل دول العالم، والمناهج، والمواد، والأنظمة التعليمية وصفوفها، والمستويات الأكاديمية — للمزامنة. |
| GET | /v1/versions | curriculum:read | نسخ منهج واحد وحالاتها. |
| GET | /v1/webhooks | webhook:manage | اشتراكات هذا العميل وحده، لا اشتراكات غيره، ولا سرّ. |
| POST | /v1/webhooks | webhook:manage | اشترك بعنوان https في أحداث؛ سرّ التوقيع في هذا الرد وحده. |
| DELETE | /v1/webhooks/{id} | webhook:manage | احذف اشتراكًا؛ لا يُرسل إليه شيء بعدها. |
| GET | /v1/webhooks/{id} | webhook:manage | اشتراكات هذا العميل وحده، لا اشتراكات غيره، ولا سرّ. |
| POST | /v1/webhooks/{id}/rotate-secret | webhook:manage | سرّ توقيع جديد في هذا الرد وحده؛ ويتوقف القديم فورًا. |
محجوز في العقد، غير مخدوم
هذه المسارات مسمّاة في العقد لكن لا مسار لها في هذا البناء. لا تستدعها — ستفشل.
- /v1/subjects
- /v1/skills
- /v1/standards
- /v1/search
- /v1/exports
- /v1/diffs
- /v1/overlays
- /v1/translations
- /v1/audit-events
- /v1/tenants
تثبيت النسخة
مرّر version مع كل قراءة معرفية، أو اترك الحل إلى latest_published — والرد يعيد الرقم الكامل المحلول دائمًا.