API-referencia

Verziózott, csak olvasható nyilvános adat-API

Hivatkozási és keresési végpontok nyilvános szabályzati metaadatokhoz. Minden JSON-végpont verziószámmal van ellátva, a következő alatt: /api/public/v1.

Amit az API visszaad

Csak olvasható követő-metaadatok: kanonikus rekord URL-ek, nyilvános JSON, felülvizsgálati állapotok, bizonyítékmezők, forráshivatkozások és idézési mezők.

Amit az API nem tesz

Nem módosítja a nyilvántartásokat, nem tesz közzé előkészítési futtatásokat, nem kerüli meg a felülvizsgálati állapotot, és nem helyettesíti a hivatalos egyetemi szabályzati forrásokat.

Ajánlott visszakeresés

Oldja fel kereséssel vagy entitás-álnevekkel, kérje le az egyetemi rekordot, majd csatolja az állítás bizonyítékát és a forrás-URL-eket az állításszintű válaszokhoz.

Az ügynökök és az API szerepének meghatározása

Javasolt használat ügynökök és adateszközök számára.

  • Forrásokkal alátámasztott összefoglalókhoz, nyilvános JSON-hoz, hivatkozási metaadatokhoz, az áttekintés állapotához és hivatalos forráshivatkozásokhoz.
  • A szabályzati nyelvezet tekintetében a hivatalos egyetemi oldalakat kell mérvadónak tekinteni.
  • Ne tekintse az elemzést tanácsadásnak, biztonsági útmutatásnak vagy megfelelőségi igazolásnak.
  • Az álnévegyezések, a témák és a lefedettségi pontszámok nem hoznak létre tényeket.
  • Az eszközrekordok az állítások és bizonyítékok szövegéből származnak; nem helyettesítik a hivatalos egyetemi forrás szövegezését.

Ajánlott lekérdezési sorrend

Biztonságos visszakeresési sorrend hivatkozásokkal alátámasztott válaszokat igénylő ügynököknek.

Entitás feloldása

Hívás /api/public/v1/search.json?q=... vagy ellenőrzés /api/public/v1/entities/index.json az egyetem kanonikus slugjának megtalálásához. Az alias-egyezések javítják a visszakeresés teljességét, de nem hoznak létre tényeket.

Step1

Az irányadó bejegyzés megnyitása

Lekérés /api/public/v1/universities/{slug}.json és őrizze meg a kanonikus oldal URL-jét, a nyilvános JSON URL-t, a felülvizsgálati állapotot, az utolsó ellenőrzés dátumát, a korlátozásokat és az idézési mezőket a válasszal együtt.

Step2

Állítási bizonyíték csatolása

Lekérés /api/public/v1/claims/{slug}.json ha állításszintű újrafelhasználásra van szükség. Őrizze meg a forrás-URL-eket, a forrás nyelvét, a bizonyítékrészleteket, a pillanatkép-hash-eket, a megbízhatóságot és a felülvizsgálati állapotot.

Step3

Az elemzés használata származtatott metaadatként

Lekérés /api/public/v1/analysis/universities/{slug}.json kizárólag determinisztikus származtatott metaadatként. A nem üres elemzési dimenziókhoz mindig hivatkozzon az alapul szolgáló állításazonosítókra és forrás-URL-ekre.

Step4

Végpontcsoportok

Rekordok, kiadások, widgetek, adatfolyamok és ügynökintegrációk.

Discovery

Nyilvános API-jegyzék végpontokra és megbízhatósági oldalakra mutató hivatkozásokkal, hivatkozási szabályokkal, korlátokkal és verzió-metaadatokkal.

Egyetemek

Nyilvános egyetemi rekordok listája kanonikus oldal-URL-lel, nyilvános JSON-URL-lel, felülvizsgálati állapottal, dátumokkal és darabszámokkal.

Entitáskeresés

Keresés a nyilvános egyetemi rekordokban kanonikus név, álnév, hivatalos forráscím, állításösszefoglaló, forrástartomány vagy elemzési dimenzió alapján.

Biztonságos keresési index

Pagefind használatára előkészített nyilvános keresési index, amely nem tartalmaz nyers forráspillanatképeket, magánfájlokat, közzé nem tett előkészítési bizonyítékokat és nem hiteles táblázatsorokat.

Entitásazonosítási index

Kanonikus egyetemi entitások álnevei a jobb visszakereshetőség érdekében. Az álnévegyezések nem hoznak létre nyilvános szabályzati tényeket.

Egyetemi bejegyzés

Egy hivatkozásra kész egyetemi rekord állításokkal, bizonyítékrészletekkel, forrás-URL-ekkel, bizonyossági szinttel, felülvizsgálati állapottal és jogi fenntartásokkal.

Egyetemekkel kapcsolatos állítások

Egy nyilvános egyetemi rekord állítás- és bizonyítéksorai forrás-URL-lel, forrásnyelvvel, pillanatkép-hashsel, bizonyossági szinttel és felülvizsgálati állapottal.

MI-eszközök címtára

Származtatott egyetemi MI-eszközrekordok eszközszintű elérhetőséggel, intézményi támogatási típussal, felülvizsgálati állapottal és bizonyítékrészletekkel. Az eszközrekordok feltárási metaadatok, nem hivatalos szabályzati következtetések.

Egyetemi elemzési profil

Forrásokkal alátámasztott elemzési profil dimenziókkal, bizonyító állítások azonosítóival, forrás-URL-ekkel, bizonyossági szinttel, felülvizsgálati állapottal és szabályzati lefedettségi pontszámmal.

Szabályzati lefedettségi pontszámok

A nyilvános elemzési profilok lefedettségi pontszámainak listája. A pontszámok a forrásokkal alátámasztott nyilvános lefedettség szélességét mérik, nem a szabályzatok minőségét.

Elemzési oldal minősége

Csak olvasható oldalminőségi kapuk, indexelhetőségi állapot, elemzés-felülvizsgálati munkafolyamat és a nyilvános elemzőoldalak tanácsadási korlátai.

QS 2026 lefedettség

Gyűjtési lefedettségi sorok a QS 2026 célintézményeihez, nyilvános, csak előkészítésben lévő és hiányzó rekordokra, forrásszámra, felülvizsgálati állapotra és következő lépésre vonatkozó mezőkkel.

Forrásállapot

A közzétett nyilvános forráspillanatképek és előkészítési futások forrás- és lekérési állapotának metaadatai. Javítások tervezésére szolgálnak, nem állítások közzétételére.

Felülvizsgálati sor

Közzé nem tett előkészítési futások metaadatai érvényesítési állapottal, forrásszélességgel, felismert URL-azonosítókkal és javasolt következő lépéssel.

Adatkészlet-közzététel

Kiadási jegyzék eredményfájlokkal, a sorok számával, bájtméretekkel, SHA-256 ellenőrzőösszegekkel, hivatkozással és korlátokkal.

Jelentések jegyzéke

Gépileg olvasható jelentésindex jelentés-URL-ekkel, mutatókkal, adatlinkekkel, hírcsatornákkal és kapcsolatfelvételi felfedezési adatokkal.

Jelentések kommunikációs csomagja

Géppel olvasható média-, hírlevél-, kutatói e-mail- és közösségimédia-szövegek kifejezett felhasználási határokkal.

MCP-alfa-jegyzék

Csak olvasható MCP-tervezési jegyzék engedélyezett eszközstruktúrákkal, tiltott műveletekkel és példaügynök-lekérdezésekkel.

MCP-eszközkatalógus

Csak olvasható MCP-alfa-eszközkatalógus bemeneti sémákkal, kötelező kimeneti mezőkkel és szigorúan tiltott módosításokkal.

Hivatkozási metaadatok

Géppel olvasható hivatkozási sablonok, kötelező mezők, bizonyítási szabályok, a forrásjogokra vonatkozó fenntartás és a tanácsadást kizáró határ.

Közreműködési index

Csak olvasható közreműködési munkafolyamat-metaadatok, GitHub-hibajegysablonok URL-jei, biztosítékok és közzétételi szabályok.

Hivatkozási és bizonyítási követelmények

A nyilvános adatok újrafelhasználásakor őrizze meg a bizonyítékmodellt.

  • Hivatkozzon a kanonikus oldal URL-jére és a nyilvános JSON URL-re együtt.
  • Az állítás újbóli felhasználásakor őrizze meg a forrás URL-jét, nyelvét, a pillanatkép hash-értékét, a bizonyítékrészletet, a megbízhatóságot és a felülvizsgálati állapotot.
  • A megbízhatóság és a felülvizsgálati állapot külön mezők.
  • Az eredeti nyelvű bizonyíték az irányadó.
  • Ne mutassa be a gépi jelölt vagy felülvizsgálatra váró állításokat végleges szakpolitikai következtetésként.
  • A közreműködési végpontok csak metaadatok. A nyilvános beküldések GitHub-hibajegy-sablonokon keresztül hoznak létre felülvizsgálati feladatokat, nem közvetlen kanonikus tényeket.

Beágyazható widgetek szerződése

A nyilvános widgetek ugyanazt az API-szerződést használják; a beágyazható widget-JSON és az entitáskeresés számára engedélyezett a CORS.

JavaScript beágyazás

A beágyazó szkript egy tömör Shadow DOM kártyát jelenít meg, és csak a widgetre specifikus nyilvános JSON-adatokat olvassa. Visszahivatkozik a kanonikus nyomonkövető oldalakra, és kerüli az át nem vizsgált állításszöveget.

Script/widgets/embed.js

Oldalak közötti használat

A widget JSON-végpontjai és a nyilvános entitáskeresési végpont megengedő CORS-fejléceket tartalmaznak a nyilvános beágyazás és a böngészőalapú lekérdezés céljából. A többi nyilvános API-végpont normál, azonos eredetű (same-origin) JSON marad, kivéve, ha külön dokumentálva van.

CORSWidgets and search

Kéréskorlát- és keresőrobot-szabályzat

Ez nyilvános méltányoshasználat-szabályzat, nem fizetős API-SLA.

Javasolt korlát
60 requests per minute per client for public JSON usage
Kliens-oldali gyorsítótár
3600 legalább másodperc
Tömeges használat
Use dataset release artifacts instead of repeatedly walking per-university endpoints.
Crawler-használat
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.