الرئيسية ← واجهة المطورين

واجهة المطورين وAPI

واجهة قراءة عامة ثابتة تساعد المواقع والتطبيقات على اكتشاف أقسام المنصة وقراءة الفهارس المصرح بها. لا تحتوي على بنود مقاييس محمية، ولا تمنح ترخيصًا تلقائيًا لإعادة النشر، ولا تُستخدم لبناء تشخيص آلي.

الإصدار: v1المصادر المصرح بها: 0الدورات المنشورة: 0السياسة: رفض افتراضي

نقاط النهاية

الرابط	الغرض
`https://healthrenewal.org/api/v1/platform.json`	اكتشاف المنصة والموارد الأصلية
`https://healthrenewal.org/api/v1/courses.schema.json`	مخطط تغذية الدورات
`https://healthrenewal.org/api/v1/health.json`	حالة الواجهة وإصدار العقد
`https://healthrenewal.org/api/v1/site.json`	بيانات تعريف المنصة
`https://healthrenewal.org/api/v1/sections.json`	فهرس الأقسام
`https://healthrenewal.org/api/v1/courses.json`	الدورات ذات الإذن النشط
`https://healthrenewal.org/api/v1/sources.json`	المصادر المصرح بها
`https://healthrenewal.org/api/v1/openapi.json`	عقد OpenAPI 3.1 الموحد
`https://healthrenewal.org/api/v1/content-index.json`	بيان فهرس الصفحات العامة وروابط الدفعات
`https://healthrenewal.org/api/v1/taxonomy.json`	تصنيف اللغات والأقسام والموضوعات

سياسة استيراد الدورات

لا يُفعّل أي مصدر لمجرد أن بياناته متاحة للعامة. يتطلب التفعيل إذنًا مكتوبًا ومرجعًا داخليًا قابلًا للتدقيق وتاريخ منح الإذن ورابط الترخيص وتصريحًا صريحًا باستيراد الفهرس. يقتصر النقل على JSON أو CSV من نطاقات HTTPS مدرجة في قائمة السماح، مع حدود للحجم وعدد السجلات ومنع التحويل إلى نطاق غير مصرح به.

عرض دورة في الفهرس لا يعني اعتمادها علميًا أو ضمان جودتها أو منح حق نسخ موادها. تبقى شروط الجهة المالكة هي المرجع.

الحفاظ على التوافق

تُدمج نقاط القراءة الجديدة مع عقد API الأصلي بدل استبداله؛ لذلك تبقى ملفات اكتشاف المنصة ومخطط الدورات والمثال التوضيحي متاحة، وتضاف إليها الصحة والأقسام والمصادر والدورات ذات الإذن النشط.

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

احتفظ برابط المصدر والترخيص عند عرض البيانات.
لا تستخدم الواجهة لتشخيص أو قرار علاجي أو تعليمي.
لا تنسخ بنود المقاييس أو مفاتيح التصحيح أو المواد المقيدة.
طبّق التخزين المؤقت ومعدل طلبات معقولًا.

مثال قراءة

fetch('https://healthrenewal.org/api/v1/sections.json')
  .then(response => response.json())
  .then(data => console.log(data.sections));

اكتشاف المحتوى

يوفر الفهرس بيانات وصفية للصفحات العامة في دفعات محدودة الحجم، مع تصنيف موضوعي يساعد المواقع والتطبيقات على بناء بحث وقوائم دون جمع بيانات مستخدمين.

توثيق فهرس المحتوى والتصنيف