Rujukan API

API data awam berversi dan baca sahaja.

Titik akhir petikan dan carian untuk metadata dasar awam. Setiap titik akhir JSON dikawal versi di bawah /api/public/v1.

Apa yang dikembalikan oleh API

Metadata penjejak baca sahaja: URL rekod kanonikal, JSON awam, status semakan, medan bukti, pautan sumber, dan medan petikan.

Perkara yang tidak dilakukan oleh API

Ia tidak mengubah rekod, menerbitkan larian pementasan, memintas keadaan semakan, atau menggantikan sumber dasar universiti rasmi.

Pengambilan semula yang disyorkan

Selesaikan dengan carian atau alias entiti, ambil rekod universiti, kemudian lampirkan bukti tuntutan dan URL sumber untuk jawapan peringkat tuntutan.

Kedudukan ejen dan API

Penggunaan yang disyorkan untuk ejen dan alat data.

  • Digunakan untuk ringkasan yang disokong sumber, JSON awam, metadata petikan, status semakan dan pautan sumber rasmi.
  • Gunakan halaman rasmi universiti sebagai pihak berkuasa bagi bahasa dasar.
  • Jangan anggap analisis sebagai nasihat, panduan keselamatan, atau kepatuhan.
  • Padanan alias, tema dan skor liputan tidak mencipta fakta.
  • Rekod alat diterbitkan daripada teks dakwaan dan bukti; ia tidak menggantikan bahasa sumber rasmi universiti.

Urutan pengambilan semula yang disyorkan

Urutan pengambilan yang selamat untuk ejen yang memerlukan jawapan bersandarkan petikan.

Selesaikan entiti

Panggilan /api/public/v1/search.json?q=... atau periksa /api/public/v1/entities/index.json untuk mencari slug universiti yang kanonik. Padanan alias meningkatkan ingatan semula, tetapi tidak mewujudkan fakta.

Step1

Buka rekod kanonikal

Dapatkan /api/public/v1/universities/{slug}.json dan kekalkan URL halaman kanonikal, URL JSON awam, keadaan semakan, tarikh terakhir disemak, had, dan medan petikan bersama jawapan tersebut.

Step2

Lampirkan bukti tuntutan

Dapatkan /api/public/v1/claims/{slug}.json apabila penggunaan semula pada tahap tuntutan diperlukan. Kekalkan URL sumber, bahasa sumber, petikan bukti, hash snapshot, tahap keyakinan dan keadaan semakan.

Step3

Gunakan analisis sebagai metadata terbitan

Dapatkan /api/public/v1/analysis/universities/{slug}.json hanya sebagai metadata terbitan deterministik. Sentiasa petik ID tuntutan asas dan URL sumber untuk dimensi analisis yang tidak kosong.

Step4

Kumpulan titik akhir

Rekod, keluaran, widget, suapan dan penyepaduan ejen.

Discovery

Indeks API awam dengan pautan titik akhir, halaman kepercayaan, peraturan petikan, batasan dan metadata versi.

Indeks carian selamat

Indeks carian awam sedia Pagefind yang mengecualikan petikan keadaan sumber mentah, fail peribadi, bukti pementasan yang belum diterbitkan dan baris hamparan bukan berwibawa.

Indeks penyelesaian entiti

Alias entiti universiti kanonik untuk meningkatkan perolehan hasil carian. Padanan alias tidak mewujudkan fakta dasar awam.

Dakwaan universiti

Baris dakwaan dan bukti bagi satu rekod universiti awam dengan URL sumber, bahasa sumber, hash petikan keadaan, tahap keyakinan dan status semakan.

Direktori alat AI

Rekod terbitan alat AI universiti dengan ketersediaan setiap alat, jenis sokongan, status semakan dan petikan bukti. Rekod alat ialah metadata penemuan, bukan kesimpulan dasar rasmi.

Kualiti halaman analisis

Pintu semakan kualiti halaman (baca sahaja), status kebolehindeksan, aliran kerja semakan analisis, dan had tanpa nasihat bagi halaman analisis awam.

Liputan QS 2026

Baris liputan pengumpulan bagi sasaran QS 2026 dengan medan awam, pementasan sahaja, tiada, bilangan sumber, status semakan dan tindakan seterusnya.

Kesihatan sumber

Metadata kesihatan sumber dan pengambilan bagi petikan keadaan sumber yang telah diterbitkan serta pelaksanaan pementasan. Digunakan untuk merancang pembaikan, bukan menerbitkan dakwaan.

Barisan gilir semakan

Metadata pelaksanaan pementasan yang belum diterbitkan dengan status pengesahan, keluasan sumber, pengecam URL yang dikesan dan cadangan tindakan seterusnya.

Manifest alfa MCP

Manifest reka bentuk MCP baca sahaja dengan struktur alat yang dibenarkan, tindakan yang dilarang dan contoh pertanyaan ejen.

Metadata sitasi

Templat petikan boleh baca mesin, medan wajib, peraturan bukti, peringatan hak sumber dan batas tanpa nasihat.

Keperluan petikan dan bukti

Kekalkan model bukti apabila menggunakan semula data awam.

  • Petik URL halaman kanonikal dan URL JSON awam bersama-sama.
  • Kekalkan URL sumber, bahasa, cincangan fotopegun, keratan bukti, keyakinan, dan keadaan semakan dengan penggunaan semula tuntutan.
  • Keyakinan dan keadaan semakan ialah medan yang berasingan.
  • Bukti bahasa asal adalah kanonikal.
  • Jangan kemukakan dakwaan calon mesin atau dakwaan yang perlu disemak sebagai kesimpulan dasar muktamad.
  • Titik akhir sumbangan hanya metadata. Penyerahan awam mencipta tugasan semakan melalui templat isu GitHub, bukan fakta kanonik secara langsung.

Kontrak widget boleh benam

Widget awam menggunakan kontrak API yang sama, dengan CORS didayakan untuk JSON widget boleh benam dan carian entiti.

Benam JavaScript

Skrip benam memaparkan kad Shadow DOM yang ringkas dan hanya membaca JSON awam khusus widget. Ia memautkan semula ke halaman penjejak kanonik dan mengelakkan teks dakwaan yang belum disemak.

Script/widgets/embed.js

Penggunaan merentas laman

Titik akhir JSON widget dan titik akhir carian entiti awam menyertakan pengepala CORS permisif untuk pembenaman awam dan carian berasaskan pelayar. Titik akhir API awam lain kekal sebagai JSON punca sama biasa melainkan didokumenkan secara berasingan.

CORSWidgets and search

Dasar had kadar dan perangkak

Ini dasar penggunaan saksama awam, bukan perjanjian tahap perkhidmatan API berbayar.

Had yang dicadangkan
60 requests per minute per client for public JSON usage
Cache klien
3600 saat minimum
Penggunaan pukal
Use dataset release artifacts instead of repeatedly walking per-university endpoints.
Penggunaan perangkak
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.