مرجع API

واجهة برمجة تطبيقات عامة للبيانات، بإصدارات، للقراءة فقط

نقاط الوصول للاقتباس والبحث عن البيانات الوصفية للسياسات العامة. يُحدَّد إصدار كل نقطة وصول بصيغة JSON ضمن /api/public/v1.

ما ترجعه واجهة برمجة التطبيقات (API)

بيانات وصفية لمتتبع للقراءة فقط: عناوين URL القياسية للسجلات، وملفات JSON العامة، وحالات المراجعة، وحقول الأدلة، وروابط المصادر، وحقول الاستشهاد.

ما لا تفعله واجهة برمجة التطبيقات

لا يعدّل السجلات، ولا ينشر عمليات التشغيل المرحلية، ولا يتجاوز حالة المراجعة، ولا يحل محل مصادر السياسات الجامعية الرسمية.

الاسترجاع الموصى به

قم بحل الاستعلام باستخدام البحث أو أسماء الكيانات البديلة، واجلب سجل الجامعة، ثم أرفق أدلة الادعاءات وعناوين URL للمصادر للحصول على إجابات على مستوى الادعاءات.

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

تحديد الكيان

اتصال /api/public/v1/search.json?q=... أو افحص /api/public/v1/entities/index.json للعثور على المعرّف القياسي (slug) للجامعة. تحسّن مطابقات الأسماء البديلة الاسترجاع، لكنها لا تُنشئ حقائق.

Step1

افتح السجل المرجعي

جلب /api/public/v1/universities/{slug}.json والاحتفاظ بعنوان URL للصفحة الأساسية، وعنوان URL العام لملف JSON، وحالة الفحص، وتاريخ آخر تحقق، والقيود، وحقول الاستشهاد مع الإجابة.

Step2

إرفاق دليل الدعوى

جلب /api/public/v1/claims/{slug}.json عند الحاجة إلى إعادة استخدام على مستوى الادعاء. احتفظ بعناوين URL للمصادر ولغة المصدر ومقتطفات الأدلة وتجزئات اللقطات ودرجة الثقة وحالة المراجعة.

Step3

استخدم التحليل كبيانات وصفية مستنتجة

جلب /api/public/v1/analysis/universities/{slug}.json فقط كبيانات وصفية مشتقة حتمية. استشهد دائماً بمعرفات ادعاءات الأساس وعناوين URL للمصادر لأبعاد التحليل غير الفارغة.

Step4

Discovery

فهرس API العام مع روابط نقاط النهاية وصفحات الموثوقية وقواعد الاستشهاد والقيود والبيانات الوصفية للإصدار.

GET/api/public/v1/index.jsonRead-only

الجامعات

قائمة سجلات الجامعات العامة مع رابط الصفحة القياسي ورابط JSON العام وحالة المراجعة والتواريخ والأعداد.

GET/api/public/v1/universities.jsonRead-only

البحث عن الكيانات

ابحث في سجلات الجامعات العامة بالاسم القياسي أو الاسم البديل أو عنوان المصدر الرسمي أو ملخص الادعاء أو نطاق المصدر أو بُعد التحليل.

GET/api/public/v1/search.json?q={query}Read-only

فهرس بحث آمن

فهرس بحث عام جاهز لـ Pagefind يستبعد لقطات المصادر الخام والملفات الخاصة والأدلة التمهيدية غير المنشورة وصفوف جداول البيانات غير المعتمدة مرجعًا.

GET/api/public/v1/search/index.jsonRead-only

فهرس تحديد الكيانات

أسماء بديلة للكيانات الجامعية القياسية لتحسين استرجاع النتائج. لا ينشئ تطابق الأسماء البديلة حقائق عامة بشأن السياسات.

GET/api/public/v1/entities/index.jsonRead-only

سجل الجامعة

سجل جامعة جاهز للاستشهاد يتضمن الادعاءات ومقتطفات الأدلة وروابط المصادر ومستوى الثقة وحالة المراجعة وتحفظات الحقوق.

GET/api/public/v1/universities/{slug}.jsonRead-only

الادعاءات المتعلقة بالجامعات

صفوف الادعاءات والأدلة لسجل جامعة عام واحد، مع رابط المصدر ولغته وبصمة اللقطة ومستوى الثقة وحالة المراجعة.

GET/api/public/v1/claims/{slug}.jsonRead-only

دليل أدوات الذكاء الاصطناعي

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

GET/api/public/v1/tools.jsonRead-only

التغييرات الأخيرة

عمليات التحقق الأخيرة من المصادر العامة وسجلات المؤسسات التي تغيرت.

GET/api/public/v1/recent-changes.jsonRead-only

فهرس واجهة برمجة التحليل

أبعاد حتمية لتحليل السياسات ومسارات نقاط النهاية والقيود والبيانات الوصفية لإصدار المخطط.

GET/api/public/v1/analysis/index.jsonRead-only

ملف تحليل الجامعة

ملف تحليل مستند إلى المصادر يتضمن الأبعاد ومعرّفات الادعاءات الداعمة وروابط المصادر ومستوى الثقة وحالة المراجعة ودرجة تغطية السياسات.

GET/api/public/v1/analysis/universities/{slug}.jsonRead-only

درجات تغطية السياسات

قائمة درجات التغطية للملفات التحليلية العامة. تقيس الدرجات اتساع التغطية العامة المستندة إلى مصادر، لا جودة السياسة.

GET/api/public/v1/analysis/coverage-scores.jsonRead-only

جودة صفحة التحليل

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

GET/api/public/v1/analysis/page-quality.jsonRead-only

تغطية QS 2026

صفوف تغطية الجمع لأهداف QS 2026، مع حقول العام والتمهيدي فقط والمفقود وعدد المصادر وحالة المراجعة والإجراء التالي.

GET/api/public/v1/coverage/qs-2026.jsonRead-only

حالة المصادر

بيانات وصفية لسلامة المصادر والجلب للقطات المصادر التي اعتُمدت للنشر العام وعمليات التشغيل التمهيدية. تُستخدم لتخطيط الإصلاح، لا لنشر الادعاءات.

GET/api/public/v1/source-health.jsonRead-only

قائمة انتظار المراجعة

بيانات وصفية لعمليات تشغيل تمهيدية غير منشورة، مع حالة التحقق وتنوع المصادر ومعرّفات الروابط المكتشفة والإجراء التالي الموصى به.

GET/api/public/v1/review/queue.jsonRead-only

إصدار مجموعة البيانات

بيان الإصدار مع المخرجات وأعداد الصفوف والأحجام بالبايت ومجاميع التحقق SHA-256 والاستشهاد والقيود.

GET/api/public/v1/datasets/latest.jsonRead-only

فهرس التقارير

فهرس التقارير القابلة للقراءة الآلية، ويتضمن عناوين URL للتقارير والمقاييس وروابط البيانات والخلاصات (feeds) واكتشاف جهات التواصل.

GET/api/public/v1/reports/index.jsonRead-only

الإبلاغ عن بيانات المخطط

توزيعات جاهزة للرسوم البيانية للغات المصادر وحالات المراجعة والتغطية الإقليمية وتغطية المدن والحرم الجامعي والتصنيفات في أحدث تقرير شهري.

GET/api/public/v1/reports/monthly/2026-09/chart-data.jsonRead-only

حزمة نشر التقارير وترويجها

نصوص قابلة للقراءة آليًا للإعلام والنشرات ورسائل الباحثين ووسائل التواصل، مع حدود استخدام صريحة.

GET/api/public/v1/reports/outreach.jsonRead-only

فهرس عناصر واجهة المستخدم

بيانات اكتشاف الأدوات المصغّرة مع رابط البرنامج النصي والأدوات المدعومة والقيود ومثال HTML.

GET/api/public/v1/widgets/index.jsonRead-only

أداة حالة الجامعة المصغّرة

بيانات مصغّرة موجزة تتضمن الحداثة وحالة المراجعة وأعداد الادعاءات والمصادر والروابط القياسية.

GET/api/public/v1/widgets/university-status/{slug}.jsonRead-only

أداة التغييرات الأخيرة المصغّرة

بيانات موجزة للتغييرات الأخيرة لأدوات التحقق من المصادر العامة والتغييرات المصغّرة.

GET/api/public/v1/widgets/recent-changes.jsonRead-only

أداة تغطية السياسة

بيانات موجزة لأداة تغطية السياسات المصغّرة، مستندة إلى المصادر. التغطية تقيس الاتساع، لا جودة السياسات.

GET/api/public/v1/widgets/policy-coverage/{slug}.jsonRead-only

أداة حداثة المصدر

بيانات موجزة لأداة حداثة المصادر المصغّرة، مع تاريخ آخر تحقق وعدد المصادر وأعداد سلامة المصادر العامة.

GET/api/public/v1/widgets/source-freshness/{slug}.jsonRead-only

عنصر واجهة مستخدم لحالة المراجعة

بيانات موجزة لأداة حالة المراجعة المصغّرة، مع مستوى الثقة وأعداد الادعاءات المراجَعة والمرشحة.

GET/api/public/v1/widgets/review-state/{slug}.jsonRead-only

بيان MCP التجريبي الأولي

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

GET/api/public/v1/mcp/manifest.jsonRead-only

كتالوج أدوات MCP

دليل أدوات MCP التجريبي الأولي للقراءة فقط، مع مخططات الإدخال وحقول الإخراج المطلوبة وعمليات التعديل المحظورة قطعًا.

GET/api/public/v1/mcp/tool-catalog.jsonRead-only

سياسة حدود المعدل

سياسة عامة قابلة للقراءة آليًا للاستخدام المنصف للوصول عبر API والأدوات المصغّرة وبرامج الزحف.

GET/api/public/v1/rate-limit-policy.jsonRead-only

البيانات الوصفية للاستشهاد

قوالب استشهاد قابلة للقراءة آليًا، وحقول مطلوبة، وقواعد للأدلة، وتحفظ بشأن حقوق المصادر، وحدود تمنع تقديم المشورة.

GET/api/public/v1/citation.jsonRead-only

مؤشر المساهمة

بيانات وصفية للقراءة فقط لسير عمل المساهمة، وروابط قوالب مسائل GitHub، وضمانات وقواعد للنشر.

GET/api/public/v1/contributions/index.jsonRead-only

سياسة مراجعة المساهمات

تعريفات قوائم المراجعة للقراءة فقط، وحدود الإشراف، وشروط النشر.

GET/api/public/v1/contributions/review-policy.jsonRead-only

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

تضمين JavaScript

يعرض سكربت التضمين بطاقة مدمجة بنموذج Shadow DOM، ولا يقرأ سوى ملف JSON العام الخاص بالأداة. ويربط بصفحات المتتبع المعيارية، ويتجنب نص الادعاءات غير المراجَعة.

Script/widgets/embed.js

الاستخدام عبر المواقع

تتضمن نقاط نهاية JSON لعنصر الواجهة ونقطة نهاية البحث عن الكيانات العامة ترويسات CORS تسمح بالتضمين العام والبحث القائم على المتصفح. وتظل نقاط نهاية واجهة برمجة التطبيقات (API) العامة الأخرى بتنسيق JSON عادي من نفس الأصل ما لم يُوثق خلاف ذلك بشكل منفصل.

CORSWidgets and search

الحد المقترح: 60 requests per minute per client for public JSON usage
ذاكرة التخزين المؤقت للعميل: 3600 ثوانٍ كحد أدنى
الاستخدام بالجملة: Use dataset release artifacts instead of repeatedly walking per-university endpoints.
استخدام أدوات الزحف: Use the sitemap, llms.txt, dataset manifest, and public API index. Do not bypass robots, login walls, paywalls, or university source-site terms.

This is a public fair-use policy, not a paid API SLA. Limits may be enforced or adjusted as traffic grows.