API referansı

Sürümlü, salt okunur kamu veri API'si

Kamu politikası meta verileri için atıf ve arama uç noktaları. Her JSON uç noktası şu yol altında sürümlendirilmiştir /api/public/v1.

API'nin döndürdüğü sonuçlar

Yalnızca okunabilir takip sistemi meta verileri: standart kayıt URL'leri, kamuya açık JSON, inceleme durumları, kanıt alanları, kaynak bağlantıları ve atıf alanları.

API'nin yapmadıkları

Kayıtları değiştirmez, hazırlama çalıştırmalarını yayımlamaz, inceleme durumunu atlatmaz veya resmî üniversite politika kaynaklarının yerini almaz.

Önerilen geri getirme

Arama veya varlık takma adlarıyla çözümleyin, üniversite kaydını getirin, ardından iddia düzeyindeki yanıtlar için iddia kanıtlarını ve kaynak URL'lerini ekleyin.

Ajan ve API konumlandırması

Ajanlar ve veri araçları için önerilen kullanım.

  • Kaynağa dayalı özetler, kamuya açık JSON, atıf üst verileri, inceleme durumu ve resmî kaynak bağlantıları için kullanın.
  • Politika dili için yetkili kaynak olarak resmi üniversite sayfalarını kullanın.
  • Analizi tavsiye, güvenlik kılavuzu veya uyumluluk olarak kabul etmeyin.
  • Takma ad eşleşmeleri, temalar ve kapsam puanları gerçek bilgi oluşturmaz.
  • Araç kayıtları iddia ve kanıt metinlerinden türetilmiştir; resmi üniversite kaynak dilinin yerini almazlar.

Önerilen erişim sırası

Atıfla desteklenen yanıtlara ihtiyaç duyan ajanlar için güvenli bir bilgi alma sırası.

Varlığı çözümle

Çağrı /api/public/v1/search.json?q=... veya inceleyin /api/public/v1/entities/index.json üniversitenin standart slug'ını bulmak için. Takma ad eşleşmeleri geri çağırmayı artırır, ancak gerçek bilgi üretmezler.

Step1

Kanonik kaydı aç

Getir /api/public/v1/universities/{slug}.json ve kurallı sayfa URL'si, kamuya açık JSON URL'si, inceleme durumu, son kontrol tarihi, sınırlamalar ve atıf alanlarını yanıtla birlikte saklayın.

Step2

İddia kanıtı ekleyin

Getir /api/public/v1/claims/{slug}.json iddia düzeyinde yeniden kullanım gerektiğinde. Kaynak URL’lerini, kaynak dilini, kanıt alıntılarını, anlık görüntü (snapshot) karma (hash) değerlerini, güven düzeyini ve inceleme durumunu koruyun.

Step3

Analizi türetilmiş meta veri olarak kullanın

Getir /api/public/v1/analysis/universities/{slug}.json yalnızca deterministik türetilmiş meta veri olarak. Boş olmayan analiz boyutları için her zaman dayanak iddia kimliklerini ve kaynak URL'lerini belirtin.

Step4

Uç nokta grupları

Kayıtlar, sürümler, bileşenler, akışlar ve ajan entegrasyonları.

Discovery

Uç nokta bağlantıları, güvenilirlik sayfaları, atıf kuralları, sınırlamalar ve sürüm meta verileri içeren herkese açık API dizini.

Üniversiteler

Kanonik sayfa URL'si, herkese açık JSON URL'si, inceleme durumu, tarihler ve sayılar içeren herkese açık üniversite kayıt listesi.

Varlık arama

Herkese açık üniversite kayıtlarını kanonik ad, diğer ad, resmî kaynak başlığı, iddia özeti, kaynak alan adı veya analiz boyutuna göre arayın.

Güvenli arama dizini

Ham kaynak anlık görüntülerini, özel dosyaları, yayımlanmamış hazırlık kanıtlarını ve yetkili kaynak sayılmayan elektronik tablo satırlarını dışlayan, Pagefind için hazır herkese açık arama dizini.

Varlık çözümleme dizini

Bulunabilirliği artıran kanonik üniversite varlıklarının diğer adları. Diğer ad eşleşmeleri, herkese açık politika olguları oluşturmaz.

Üniversite kaydı

İddialar, kanıt alıntıları, kaynak URL'leri, güven düzeyi, inceleme durumu ve haklara ilişkin uyarılar içeren atıfa hazır bir üniversite kaydı.

Üniversite iddiaları

Herkese açık bir üniversite kaydının kaynak URL'si, kaynak dili, anlık görüntü özeti, güven düzeyi ve inceleme durumu içeren iddia ve kanıt satırları.

Yapay zekâ araçları dizini

Araç düzeyinde kullanılabilirlik, kurumsal destek türü, inceleme durumu ve kanıt alıntıları içeren türetilmiş üniversite yapay zekâ aracı kayıtları. Araç kayıtları keşif meta verileridir; resmî politika sonuçları değildir.

Üniversite analiz profili

Boyutlar, kanıt niteliğindeki iddia kimlikleri, kaynak URL'leri, güven düzeyi, inceleme durumu ve politika kapsam puanı içeren kaynaklarla desteklenen analiz profili.

Politika kapsam puanları

Kamuya açık analiz profilleri için kapsam puanı listesi. Puanlar, kaynağa dayalı kamu kapsamının genişliğini ölçer; politika kalitesini değil.

Analiz sayfası kalitesi

Kamuya açık analiz sayfaları için salt okunur sayfa kalitesi kapıları, dizinlenebilirlik durumu, analiz gözden geçirme iş akışı ve tavsiye vermeme sınırları.

QS 2026 kapsamı

QS 2026 hedefleri için herkese açık, yalnızca hazırlık ortamında bulunan ve eksik kayıt, kaynak sayısı, inceleme durumu ve sonraki işlem alanlarını içeren derleme kapsam satırları.

Kaynak durumu

Yayımlanmış herkese açık kaynak anlık görüntüleri ve hazırlık çalıştırmaları için kaynak ve veri alma durumu meta verileri. İddia yayımlamak için değil, düzeltme planlamak için kullanılır.

İnceleme kuyruğu

Doğrulama durumu, kaynak çeşitliliği, algılanan kısa adlar ve önerilen sonraki işlem içeren yayımlanmamış hazırlık çalıştırması meta verileri.

Veri kümesi yayımı

Çıktılar, satır sayıları, bayt boyutları, SHA-256 sağlama toplamları, atıf ve sınırlamalar içeren sürüm bildirimi.

Raporlar dizini

Rapor URL'leri, metrikler, veri bağlantıları, beslemeler ve yaygınlaştırma keşfiyle makine tarafından okunabilir rapor dizini.

Rapor tanıtım paketi

Açık kullanım sınırları içeren, makinece okunabilir medya, bülten, araştırmacı e-postası ve sosyal medya metinleri.

MCP alfa bildirimi

İzin verilen araç yapıları, yasak işlemler ve örnek ajan sorguları içeren salt okunur MCP tasarım bildirimi.

Alıntı meta verileri

Makinece okunabilir atıf şablonları, zorunlu alanlar, kanıt kuralları, kaynak hakları uyarısı ve danışmanlık dışı kullanım sınırı.

Atıf ve kanıt gereklilikleri

Herkese açık verileri yeniden kullanırken kanıt modelini koruyun.

  • Kanonik sayfa URL'sini ve genel JSON URL'sini birlikte alıntılayın.
  • İddia yeniden kullanımında kaynak URL'sini, dili, anlık görüntü karmasını, kanıt alıntısını, güven düzeyini ve inceleme durumunu koruyun.
  • Güven ve inceleme durumu ayrı alanlardır.
  • Orijinal dildeki kanıt esastır.
  • Makine tarafından aday olarak belirlenen veya inceleme gerektiren iddiaları nihai politika sonuçları olarak sunmayın.
  • Katkı uç noktaları yalnızca üst veridir. Kamuya açık gönderimler, doğrudan kanonik olgular değil, GitHub sorun şablonları aracılığıyla inceleme görevleri oluşturur.

Gömülebilir bileşen sözleşmesi

Herkese açık bileşenler aynı API sözleşmesini kullanır; gömülebilir bileşen JSON verileri ve varlık arama için CORS etkindir.

JavaScript gömme

Gömme betiği kompakt bir Shadow DOM kartı oluşturur ve yalnızca widget'a özgü herkese açık JSON verisini okur. Kanonik izleyici sayfalarına geri bağlantı verir ve gözden geçirilmemiş iddia metinlerinden kaçınır.

Script/widgets/embed.js

Siteler arası kullanım

Widget JSON uç noktaları ve herkese açık varlık arama uç noktası, genel yerleştirme ve tarayıcı tabanlı sorgulama için izin verici CORS başlıkları içerir. Diğer genel API uç noktaları, ayrıca belgelenmediği sürece normal aynı kaynaklı JSON olarak kalır.

CORSWidgets and search

İstek sınırı ve tarama robotu politikası

Bu, ücretli bir API SLA'sı değil, herkese açık bir adil kullanım politikasıdır.

Önerilen sınır
60 requests per minute per client for public JSON usage
İstemci önbelleği
3600 en az saniye
Toplu kullanım
Use dataset release artifacts instead of repeatedly walking per-university endpoints.
Tarayıcı (crawler) kullanımı
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.