مرجع API

رابط برنامه‌نویسی داده عمومی فقط‌خواندنی با نسخه‌بندی

نقاط پایانی استناد و جست‌وجو برای فراداده‌های سیاست عمومی. هر نقطه پایانی JSON تحت نسخه‌بندی زیر قرار دارد: /api/public/v1.

آنچه API بازمی‌گرداند

متادیتای فقط‌خواندنی رهگیر: نشانی‌های وب سوابق رسمی، JSON عمومی، وضعیت‌های بررسی، فیلدهای شواهد، پیوندهای منابع و فیلدهای استناد.

آنچه API انجام نمی‌دهد

این سامانه سوابق را دستکاری نمی‌کند، اجراهای مرحله آماده‌سازی را منتشر نمی‌کند، از وضعیت بررسی عبور نمی‌کند و جایگزین منابع رسمی سیاست دانشگاه نمی‌شود.

بازیابی توصیه‌شده

از طریق جستجو یا نام‌های مستعار موجودیت مطابقت دهید، رکورد دانشگاه را بازیابی کنید، سپس شواهد ادعا و نشانی‌های وب منابع را برای پاسخ‌های سطح ادعا ضمیمه نمایید.

جایگاه عامل و API

کاربرد پیشنهادی برای عامل‌ها و ابزارهای داده.

  • برای خلاصه‌های دارای منبع، JSON عمومی، فراداده‌های ارجاع، وضعیت بازبینی و پیوندهای منبع رسمی.
  • صفحات رسمی دانشگاه را به‌عنوان مرجع زبان سیاست به‌کار ببرید.
  • تحلیل را توصیه، راهنمای ایمنی یا انطباق ندانید.
  • تطابق‌های نام مستعار، موضوع‌ها و امتیازهای پوشش، واقعیت ایجاد نمی‌کنند.
  • سوابق ابزارها از متن ادعا و شواهد برگرفته شده‌اند؛ آنها جایگزین زبان منبع رسمی دانشگاه نمی‌شوند.

ترتیب توصیه‌شده بازیابی

ترتیب امن بازیابی برای عامل‌های نیازمند پاسخ‌های مستند به استناد.

تعیین موجودیت

تماس /api/public/v1/search.json?q=... یا بازرسی کنید /api/public/v1/entities/index.json برای یافتن اسلاگ استاندارد دانشگاه. تطبیق با نام‌های مستعار بازیابی را بهبود می‌دهد، اما واقعیت جدیدی ایجاد نمی‌کند.

Step1

سابقهٔ معتبر را باز کنید

واکشی /api/public/v1/universities/{slug}.json و فیلدهای URL صفحه اصلی، URL عمومی JSON، وضعیت بررسی، تاریخ آخرین بررسی، محدودیت‌ها و استنادها را همراه با پاسخ نگه دارید.

Step2

پیوست کردن شواهد ادعا

واکشی /api/public/v1/claims/{slug}.json هنگامی که بازاستفاده در سطح ادعا لازم است. نشانی‌های منبع، زبان منبع، قطعه‌های شواهد، هش‌های عکس‌لحظه‌ای (snapshot)، میزان اطمینان و وضعیت بازبینی را حفظ کنید.

Step3

استفاده از تحلیل به عنوان فراداده استخراج‌شده

واکشی /api/public/v1/analysis/universities/{slug}.json صرفاً به عنوان متادیتای اشتقاقی قطعی. همواره شناسه‌های ادعای مبنا و نشانی‌های وب منابع را برای ابعاد تحلیل غیرخالی ذکر کنید.

Step4

گروه‌های نقاط پایانی

رکوردها، انتشارها، ابزارک‌ها، خوراک‌ها و یکپارچه‌سازی عامل‌ها.

Discovery

نمایه API عمومی با پیوند نقاط پایانی، صفحات اعتماد، قواعد استناد، محدودیت‌ها و فراداده نسخه.

دانشگاه‌ها

فهرست عمومی رکوردهای دانشگاه با URL صفحه معیار، URL عمومی JSON، وضعیت بازبینی، تاریخ‌ها و شمارش‌ها.

جست‌وجوی موجودیت

جست‌وجوی رکوردهای عمومی دانشگاه بر اساس نام معیار، نام دیگر، عنوان منبع رسمی، خلاصه ادعا، دامنه منبع یا بُعد تحلیل.

نمایه جست‌وجوی امن

نمایه جست‌وجوی عمومی آماده Pagefind، بدون تصویرهای خام منبع، فایل‌های خصوصی، شواهد موقت منتشرنشده و ردیف‌های غیرمرجع صفحه‌گسترده.

نمایه تطبیق موجودیت

نام‌های دیگر موجودیت‌های معیار دانشگاهی برای افزایش بازیابی. تطبیق نام دیگر، واقعیت سیاستی عمومی ایجاد نمی‌کند.

سابقه دانشگاهی

یک رکورد دانشگاه آماده استناد با ادعاها، گزیده شواهد، URL منابع، میزان اطمینان، وضعیت بازبینی و ملاحظات حقوقی.

ادعاهای دانشگاه

ردیف‌های ادعا/شواهد یک رکورد عمومی دانشگاه با URL منبع، زبان منبع، هش تصویر وضعیت، میزان اطمینان و وضعیت بازبینی.

فهرست ابزارهای هوش مصنوعی

رکوردهای مشتق‌شده ابزارهای هوش مصنوعی دانشگاه با دسترس‌پذیری هر ابزار، نوع تأیید، وضعیت بازبینی و گزیده شواهد. این رکوردها فراداده کشف هستند، نه نتیجه رسمی سیاستی.

فهرست API تحلیل

ابعاد قطعی تحلیل سیاست، مسیر نقاط پایانی، محدودیت‌ها و فراداده نسخه طرح‌واره.

نمایه تحلیل دانشگاه

پروفایل تحلیل مستند به منابع با ابعاد، شناسه ادعاهای شواهد، URL منابع، میزان اطمینان، وضعیت بازبینی و امتیاز پوشش سیاست.

امتیازهای پوشش سیاست

فهرست امتیازهای پوشش برای پروفایل‌های تحلیل عمومی. امتیازها گستره پوشش منبع‌محور عمومی را می‌سنجند، نه کیفیت سیاست.

کیفیت صفحه تحلیل

دروازه‌های کیفیت صفحه فقط‌خواندنی، وضعیت قابلیت نمایه‌سازی، گردش کار بازبینی تحلیل و مرزهای عدم ارائه توصیه برای صفحات تحلیل عمومی.

پوشش QS 2026

ردیف‌های پوشش گردآوری برای اهداف QS 2026 با فیلدهای عمومی، فقط موقت، مفقود، شمار منابع، وضعیت بازبینی و اقدام بعدی.

سلامت منابع

فراداده سلامت منبع/واکشی برای تصویرهای منابع عمومی منتشرشده و اجراهای موقت. برای برنامه‌ریزی اصلاح است، نه انتشار ادعا.

صف بررسی

فراداده اجرای موقت منتشرنشده با وضعیت اعتبارسنجی، گستره منابع، نامک‌های شناسایی‌شده و اقدام بعدی پیشنهادی.

انتشار مجموعه داده

فهرست انتشار با خروجی‌ها، شمار ردیف‌ها، اندازه بایت، مجموع‌های وارسی SHA-256، استناد و محدودیت‌ها.

فهرست گزارش‌ها

فهرست گزارش‌های قابل‌خواندن برای ماشین، همراه با نشانی گزارش‌ها، معیارها، پیوندهای داده، خوراک‌ها و کشف برای اطلاع‌رسانی.

داده‌های نمودار گزارش

توزیع‌های آماده نمودار زبان منبع، وضعیت بازبینی، پوشش منطقه، شهر/پردیس و رتبه‌بندی برای آخرین گزارش ماهانه.

بسته ترویج گزارش‌ها

متن ماشین‌خوان برای رسانه، خبرنامه، ایمیل پژوهشگران و شبکه‌های اجتماعی با حدود استفاده روشن.

نمایه ویجت

داده کشف ابزارک با URL اسکریپت، ابزارک‌های پشتیبانی‌شده، محدودیت‌ها و نمونه HTML.

ویجت وضعیت بازبینی

داده فشرده ابزارک وضعیت بازبینی با میزان اطمینان، ادعاهای بازبینی‌شده و شمار ادعاهای نامزد.

فهرست MCP آلفا

فهرست طراحی فقط‌خواندنی MCP با ساختارهای مجاز ابزار، اقدامات ممنوع و نمونه پرس‌وجوهای عامل.

کاتالوگ ابزارهای MCP

فهرست ابزارهای فقط‌خواندنی MCP آلفا با طرح‌واره ورودی، فیلدهای الزامی خروجی و تغییرات مطلقاً ممنوع.

سیاست محدودیت نرخ

سیاست عمومی و ماشین‌خوان استفاده منصفانه برای دسترسی API، ابزارک و خزنده.

متاداده ارجاع

الگوهای ماشین‌خوان استناد، فیلدهای الزامی، قواعد شواهد، ملاحظه حقوق منبع و مرز عدم ارائه مشاوره.

شاخص مشارکت

فراداده فقط‌خواندنی روند مشارکت، URL الگوهای مسئله GitHub، تدابیر حفاظتی و قواعد انتشار.

الزامات استناد و شواهد

هنگام استفاده مجدد از داده عمومی، مدل شواهد را حفظ کنید.

  • URL صفحه اصلی و URL عمومی JSON را با هم ذکر کنید.
  • نشانی وب منبع، زبان، هش تصویر لحظه‌ای، قطعه شواهد، میزان اطمینان و وضعیت بازبینی را هنگام استفاده مجدد از ادعا حفظ کنید.
  • اطمینان و وضعیت بازبینی فیلدهای جداگانه‌ای هستند.
  • شواهد به زبان اصلی سندیت دارند.
  • ادعاهای نامزد ماشینی یا ادعاهای نیازمند بازبینی را به‌عنوان نتیجه‌گیری‌های نهایی سیاست ارائه نکنید.
  • نقاط پایانی مشارکت فقط فراداده هستند. ارسال‌های عمومی از طریق قالب‌های issue گیت‌هاب وظایف بازبینی ایجاد می‌کنند، نه حقایق مستقیم و معتبر.

قرارداد ابزارک تعبیه‌پذیر

ابزارک‌های عمومی از همان قرارداد API استفاده می‌کنند؛ CORS برای JSON ابزارک‌های تعبیه‌پذیر و جست‌وجوی موجودیت فعال است.

جاسازی JavaScript

اسکریپت embed یک کارت فشردهٔ Shadow DOM نمایش می‌دهد و تنها JSON عمومی ویژهٔ ویجت را می‌خواند. به صفحات استاندارد ردیاب پیوند می‌دهد و از متن ادعاهای بررسی‌نشده پرهیز می‌کند.

Script/widgets/embed.js

استفاده بین‌سایتی

نقاط پایانی JSON ابزارک و نقطه پایانی عمومی جستجوی موجودیت‌ها شامل هدرهای مجاز CORS برای جاسازی عمومی و جستجوی مبتنی بر مرورگر هستند. سایر نقاط پایانی عمومی API به صورت JSON عادی هم‌مبدأ باقی می‌مانند مگر اینکه جداگانه مستند شده باشند.

CORSWidgets and search

سیاست محدودیت نرخ و خزنده

این سیاست عمومی استفاده منصفانه است، نه SLA یک API پولی.

حد پیشنهادی
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.