Referenční příručka API

Verzované veřejné datové API pouze pro čtení

Koncové body pro citace a vyhledávání metadat veřejných zásad. Každý koncový bod JSON je verzován v rámci /api/public/v1.

Co vrací API

Metadata sledovacího systému pouze pro čtení: kanonické URL záznamů, veřejný JSON, stavy posouzení, pole důkazů, odkazy na zdroje a pole citací.

Co API nedělá

Nemění záznamy, nezveřejňuje přechodné (staging) běhy, neobchází stav kontroly ani nenahrazuje oficiální zdroje zásad univerzity.

Doporučené načtení

Dohledejte pomocí vyhledávání nebo aliasů subjektu, načtěte univerzitní záznam a poté pro odpovědi na úrovni tvrzení připojte podklady tvrzení a zdrojové adresy URL.

Vymezení agentů a API

Doporučené použití pro agenty a datové nástroje.

  • Použití pro shrnutí podložená zdroji, veřejný JSON, metadata citací, stav kontroly a odkazy na oficiální zdroje.
  • Jako autoritu pro znění politiky používejte oficiální stránky univerzity.
  • Nepovažujte analýzu za doporučení, bezpečnostní pokyny ani posouzení souladu s předpisy.
  • Shody aliasů, témata a skóre pokrytí nevytvářejí žádná fakta.
  • Záznamy o nástrojích jsou odvozeny z textu tvrzení a důkazů; nenahrazují formulace oficiálních univerzitních zdrojů.

Doporučené pořadí vyhledávání

Bezpečné pořadí získávání informací pro agenty, kteří potřebují odpovědi podložené citacemi.

Vyřešit entitu

Hovor /api/public/v1/search.json?q=... nebo zkontrolovat /api/public/v1/entities/index.json k nalezení kanonického identifikátoru (slug) univerzity. Shody podle aliasů zlepšují úspěšnost vyhledávání, ale nevytvářejí fakta.

Step1

Otevřít kanonický záznam

Načíst /api/public/v1/universities/{slug}.json a ponechte pole kanonické URL stránky, veřejné JSON URL, stavu přezkumu, data poslední kontroly, omezení a citací spolu s odpovědí.

Step2

Připojit důkazy k tvrzení

Načíst /api/public/v1/claims/{slug}.json pokud je potřeba opětovné použití na úrovni tvrzení. Zachovejte zdrojové URL, jazyk zdroje, úryvky důkazů, hashe snímků, míru spolehlivosti a stav kontroly.

Step3

Použít analýzu jako odvozená metadata

Načíst /api/public/v1/analysis/universities/{slug}.json pouze jako deterministická odvozená metadata. U neprázdných dimenzí analýzy vždy citujte ID podkladových tvrzení a zdrojové adresy URL.

Step4

Skupiny koncových bodů

Záznamy, vydání, widgety, kanály a integrace agentů.

Discovery

Veřejný index API s odkazy na koncové body, stránky o důvěryhodnosti, pravidla citování, omezení a metadata verzí.

Univerzity

Seznam veřejných univerzitních záznamů s kanonickou URL stránky, URL veřejného JSON, stavem kontroly, daty a počty.

Vyhledávání entit

Vyhledávejte veřejné univerzitní záznamy podle kanonického názvu, aliasu, názvu oficiálního zdroje, shrnutí tvrzení, domény zdroje nebo rozměru analýzy.

Bezpečný vyhledávací index

Veřejný vyhledávací index připravený pro Pagefind, který nezahrnuje nezpracované snímky zdrojů, soukromé soubory, nezveřejněné důkazy z přípravného prostředí ani neautoritativní řádky tabulek.

Index rozpoznávání entit

Aliasy kanonických univerzitních entit pro lepší dohledání. Shoda s aliasem nevytváří veřejná fakta o zásadách.

Záznam univerzity

Jeden univerzitní záznam připravený k citování s tvrzeními, výňatky důkazů, URL zdrojů, mírou jistoty, stavem kontroly a výhradami k právům.

Tvrzení o univerzitách

Řádky tvrzení a důkazů jednoho veřejného univerzitního záznamu s URL a jazykem zdroje, hashem snímku, mírou jistoty a stavem kontroly.

Adresář nástrojů AI

Odvozené záznamy univerzitních nástrojů AI s dostupností jednotlivých nástrojů, typem institucionální podpory, stavem kontroly a výňatky důkazů. Záznamy nástrojů jsou metadata pro vyhledávání, nikoli oficiální závěry o zásadách.

Kvalita stránky analýzy

Brány kvality stránek pouze pro čtení, stav indexovatelnosti, pracovní postup kontroly analýz a hranice neposkytování poradenství pro veřejné analytické stránky.

Pokrytí QS 2026

Řádky pokrytí sběru pro cíle QS 2026 s poli pro veřejné, pouze přípravné a chybějící záznamy, počet zdrojů, stav kontroly a další krok.

Stav zdrojů

Metadata stavu zdrojů a načítání pro zveřejněné veřejné snímky zdrojů a přípravné běhy. Slouží k plánování oprav, nikoli ke zveřejňování tvrzení.

Fronta k přezkumu

Metadata nezveřejněných přípravných běhů se stavem validace, šíří zdrojů, zjištěnými slugy a doporučeným dalším krokem.

Rejstřík zpráv

Index strojově čitelných zpráv s odkazy na zprávy, metriky, datové odkazy, kanály a vyhledávání osvětových aktivit.

Balíček pro šíření zpráv

Strojově čitelné texty pro média, zpravodaje, e-maily výzkumníkům a sociální sítě s výslovnými hranicemi použití.

Alfa manifest MCP

Návrhový manifest MCP pouze pro čtení s povolenými strukturami nástrojů, zakázanými akcemi a příklady dotazů agentů.

Katalog nástrojů MCP

Alfa katalog nástrojů MCP pouze pro čtení se vstupními schématy, povinnými výstupními poli a přísně zakázanými změnami.

Metadata citací

Strojově čitelné citační šablony, povinná pole, pravidla důkazů, výhrada k právům zdrojů a hranice vůči poradenství.

Požadavky na citace a důkazy

Při opětovném použití veřejných dat zachovejte model důkazů.

  • Citujte společně kanonickou URL adresu stránky a veřejnou URL adresu JSON.
  • Při opětovném použití tvrzení zachovejte URL zdroje, jazyk, hash snímku, úryvek důkazu, míru spolehlivosti a stav posouzení.
  • Stav důvěryhodnosti a stav kontroly jsou samostatná pole.
  • Důkazní materiál v původním jazyce je směrodatný.
  • Nepředkládejte strojově navržená tvrzení ani tvrzení vyžadující revizi jako konečné závěry politiky.
  • Koncové body příspěvků obsahují pouze metadata. Veřejná podání vytvářejí úkoly k revizi prostřednictvím šablon GitHub issues, nikoli přímá závazná fakta.

Kontrakt vložitelných widgetů

Veřejné widgety používají stejný kontrakt API s povoleným CORS pro JSON vložitelných widgetů a vyhledávání entit.

Vložení JavaScriptu

Vkládací skript vykresluje kompaktní kartu ve Shadow DOM a čte pouze veřejný JSON specifický pro daný widget. Odkazuje zpět na kanonické stránky sledovače a nepoužívá neověřený text tvrzení.

Script/widgets/embed.js

Použití napříč weby

Koncové body JSON widgetu a koncový bod pro veřejné vyhledávání subjektů obsahují benevolentní hlavičky CORS pro veřejné vkládání a vyhledávání v prohlížeči. Ostatní veřejné koncové body rozhraní API zůstávají běžnými JSON ze stejného původu, pokud není samostatně zdokumentováno jinak.

CORSWidgets and search

Zásady limitů požadavků a prohledávačů

Jde o veřejné zásady přiměřeného používání, nikoli o placené SLA API.

Navrhovaný limit
60 requests per minute per client for public JSON usage
Klientská mezipaměť
3600 minimálně sekund
Hromadné použití
Use dataset release artifacts instead of repeatedly walking per-university endpoints.
Používání crawlerů
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.