Mitä API palauttaa
Vain luku -seurantatietojen metatiedot: kanoniset tietue-URLit, julkinen JSON, katselmointitilat, todistekentät, lähdelinkit ja viittauskentät.
API-viite
Versioitu, vain lukuun tarkoitettu julkinen tietorajapinta
Lainaus- ja hakupäätepisteet julkisen käytännön metatiedoille. Jokainen JSON-päätepiste on versioitu polun alle /api/public/v1.
Mitä API ei tee
Se ei muokkaa tietueita, julkaise testausajoja, ohita tarkistustilaa eikä korvaa yliopiston virallisia käytäntölähteitä.
Suositeltu haku
Ratkaise haulla tai entiteettien aliaksilla, hae yliopistotietue ja liitä sitten väitenäyttö ja lähde-URL-osoitteet väitetason vastauksia varten.
Agenttien ja API:n asemointi
Suositeltu käyttö agenteille ja datatyökaluille.
- Käytetään lähteisiin perustuviin yhteenvetoihin, julkiseen JSON-dataan, viitemetatietoihin, tarkistuksen tilaan ja virallisiin lähdelinkkeihin.
- Käytä yliopiston virallisia sivuja käytäntökielen lähteenä.
- Älä käsittele analyysiä neuvona, turvallisuusohjeena tai säädöstenmukaisuutena.
- Aliasvastaavuudet, teemat ja kattavuuspisteet eivät luo faktoja.
- Työkalutietueet on johdettu väite- ja näyttötekstistä; ne eivät korvaa virallista yliopiston lähdekieltä.
Suositeltu hakujärjestys
Turvallinen hakujärjestys agenteille, jotka tarvitsevat viittauksiin perustuvia vastauksia.
Selvitä kohde
Puhelu /api/public/v1/search.json?q=... tai tarkasta /api/public/v1/entities/index.json löytääksesi yliopiston vakiintuneen tunnisteen (slug). Aliasten kautta tehtävät vastaavuudet parantavat hakutuloksia, mutta ne eivät luo tosiasioita.
Avaa kanoninen tietue
Nouda /api/public/v1/universities/{slug}.json ja säilytä vastauksen mukana kanoninen sivun URL-osoite, julkinen JSON-URL-osoite, tarkastelun tila, viimeisimmän tarkistuksen päivämäärä, rajoitukset ja viitetiedot.
Liitä väitteen todisteet
Nouda /api/public/v1/claims/{slug}.json kun väitetasoinen uudelleenkäyttö on tarpeen. Säilytä lähde-URL-osoitteet, lähdekieli, todistenäytteet, tilannekuvan tiivisteet, luottamustaso ja tarkistustila.
Käytä analyysia johdettuna metatietona
Nouda /api/public/v1/analysis/universities/{slug}.json vain deterministisinä johdettuina metatietoina. Mainitse aina perusteena olevat väite-ID:t ja lähde-URL-osoitteet ei-tyhjille analyysiulottuvuuksille.
Rajapintapisteiden ryhmät
Tietueet, julkaisut, pienoisohjelmat, syötteet ja agentti-integraatiot.
Discovery
Julkinen API-hakemisto, jossa on rajapintapisteiden linkit, luotettavuussivut, viittaussäännöt, rajoitukset ja versioiden metatiedot.
Yliopistot
Julkisten yliopistotietueiden luettelo, jossa on kanoninen sivun URL, julkisen JSON-aineiston URL, tarkistustila, päivämäärät ja lukumäärät.
Entiteettihaku
Hae julkisia yliopistotietueita kanonisella nimellä, aliaksella, virallisen lähteen otsikolla, väitteen yhteenvedolla, lähteen verkkotunnuksella tai analyysiulottuvuudella.
Turvallinen hakuhakemisto
Pagefind-valmis julkinen hakuhakemisto, josta on jätetty pois käsittelemättömät lähdetilannekuvat, yksityiset tiedostot, julkaisematon valmisteluvaiheen näyttö ja taulukkolaskennan rivit, joilla ei ole auktoriteettiasemaa.
Entiteettien tunnistushakemisto
Kanonisten yliopistoentiteettien aliakset löydettävyyden parantamiseen. Aliasosumat eivät luo julkisia ohjeistuksia koskevia tosiasioita.
Yliopistotietue
Yksi viittausvalmis yliopistotietue, jossa on väitteet, näyttökatkelmat, lähteiden URL-osoitteet, luottamustaso, tarkistustila ja oikeuksia koskevat varaumat.
Yliopistoja koskevat väitteet
Yhden julkisen yliopistotietueen väite- ja näyttörivit, joissa on lähteen URL, lähdekieli, tilannekuvan tiiviste, luottamustaso ja tarkistustila.
Tekoälytyökalujen hakemisto
Johdetut yliopistojen tekoälytyökalujen tietueet, joissa on työkalukohtainen saatavuus, institutionaalisen tuen tyyppi, tarkistustila ja näyttökatkelmat. Työkalutietueet ovat löytämistä tukevia metatietoja, eivät virallisia ohjeistuksia koskevia päätelmiä.
Viimeisimmät muutokset
Viimeaikaiset julkiset lähdetarkistukset ja muuttuneet oppilaitostietueet.
Analyysi-API-indeksi
Deterministiset ohjeistusanalyysin ulottuvuudet, rajapintapisteiden polut, rajoitukset ja skeemaversion metatiedot.
Yliopiston analyysiprofiili
Lähteisiin perustuva analyysiprofiili, jossa on ulottuvuudet, näyttönä käytettyjen väitteiden tunnukset, lähteiden URL-osoitteet, luottamustaso, tarkistustila ja ohjeistusten kattavuuspisteet.
Ohjeistusten kattavuuspisteet
Kattavuuspistelista julkisille analyysiprofiileille. Pisteet mittaavat lähdepohjaisen julkisen kattavuuden laajuutta, eivät politiikan laatua.
Analyysisivun laatu
Vain luku -sivun laatuportit, indeksoitavuuden tila, analyysin tarkastusprosessi ja julkisten analyysisivujen neuvonannon rajat.
QS 2026 -kattavuus
Keruun kattavuusrivit QS 2026 -kohteille: julkiset, vain valmisteluympäristössä olevat ja puuttuvat tietueet, lähteiden määrä, tarkistustila ja seuraava toimi.
Lähteiden kunto
Julkaistujen julkisten lähdetilannekuvien ja valmisteluajojen lähteiden ja noutojen tilaa koskevat metatiedot. Käytetään korjausten suunnitteluun, ei väitteiden julkaisuun.
Tarkastusjono
Julkaisemattomien valmisteluajojen metatiedot: validointitila, lähteiden laajuus, tunnistetut osoitetunnisteet ja suositeltu seuraava toimi.
Tietoaineiston julkaisu
Julkaisumanifesti, jossa on tuotokset, rivimäärät, tavukoot, SHA-256-tarkistussummat, viittaustiedot ja rajoitukset.
Raporttien hakemisto
Koneluettavien raporttien hakemisto, jossa on raporttien URL-osoitteet, mittarit, datalinkit, syötteet sekä outreach-löydettävyys.
Raportoi kaaviodata
Uusimman kuukausiraportin kaaviovalmiit jakaumat lähdekielistä, tarkistustiloista, alueellisesta kattavuudesta, kaupunkien ja kampusten kattavuudesta sekä sijoituslistojen kattavuudesta.
Raporttien viestintäpaketti
Koneluettavat media-, uutiskirje-, tutkijasähköposti- ja sosiaalisen median tekstit, joilla on selkeät käyttörajat.
Sovelmaindeksi
Pienoisohjelmien löytämistiedot, joissa on skriptin URL, tuetut pienoisohjelmat, rajoitukset ja HTML-esimerkki.
Yliopiston tilan pienoisohjelma
Tiiviit pienoisohjelmatiedot, joissa on ajantasaisuus, tarkistustila, väitteiden ja lähteiden määrät sekä kanoniset linkit.
Viimeaikaisten muutosten pienoisohjelma
Tiiviit viimeaikaisten muutosten tiedot julkisten lähdetarkistusten ja muutosten pienoisohjelmille.
Politiikkakattavuuden pienoisohjelma
Tiiviit, lähteisiin perustuvat ohjeistusten kattavuuden pienoisohjelmatiedot. Kattavuus tarkoittaa laajuutta, ei ohjeistusten laatua.
Lähteen tuoreus -widget
Tiiviit lähteiden ajantasaisuuden pienoisohjelmatiedot, joissa on viimeisin tarkistuspäivä, lähteiden määrä ja julkiset lähteiden tilakohtaiset määrät.
Arviointitilan widgetti
Tiiviit tarkistustilan pienoisohjelmatiedot, joissa on luottamustaso sekä tarkistettujen ja ehdolla olevien väitteiden määrät.
MCP-alfamanifesti
Vain luku -käyttöön tarkoitettu MCP-suunnittelumanifesti, jossa on sallitut työkalurakenteet, kielletyt toimet ja esimerkkejä agenttien kyselyistä.
MCP-työkaluluettelo
Vain luku -käyttöön tarkoitettu MCP-alfatyökaluluettelo, jossa on syöteskeemat, pakolliset tuloskentät ja ehdottomasti kielletyt muutokset.
Kutsurajakäytäntö
Koneluettava julkinen kohtuukäyttökäytäntö API-, pienoisohjelma- ja indeksointirobottikäytölle.
Viittauksen metatiedot
Koneluettavat viittausmallit, pakolliset kentät, näyttösäännöt, lähteiden oikeuksia koskeva varauma ja neuvontaa koskeva rajaus.
Panosindeksi
Vain luku -metatiedot osallistumisen työnkulusta, GitHub-ongelmapohjien URL-osoitteet, suojatoimet ja julkaisusäännöt.
Osallistujien tuotosten tarkistuskäytäntö
Vain luku -määritelmät tarkistusjonoille, moderoinnin rajoille ja julkaisuehdoille.
Viittaus- ja näyttövaatimukset
Säilytä näyttömalli, kun käytät julkisia tietoja uudelleen.
- Ilmoita kanonisen sivun URL-osoite ja julkinen JSON-URL yhdessä.
- Säilytä lähteen URL, kieli, tilannevedoksen tiiviste, todistetekstikatkelma, luottamus ja tarkastelutila väitteen uudelleenkäytön yhteydessä.
- Luottamus ja tarkistuksen tila ovat erillisiä kenttiä.
- Alkuperäiskielinen todiste on määräävä.
- Älä esitä koneellisesti ehdotettuja tai tarkistusta vaativia väitteitä lopullisina käytäntöjohtopäätöksinä.
- Osallistumisen päätepisteet ovat pelkkää metatietoa. Julkiset lähetykset luovat tarkastustehtäviä GitHub-ongelmapohjien kautta, eivät suoria kanonisia faktoja.
Upotettavien pienoisohjelmien sopimus
Julkiset pienoisohjelmat käyttävät samaa API-sopimusta. CORS on käytössä upotettavien pienoisohjelmien JSON-tiedoille ja entiteettihaulle.
JavaScript-upotus
Upotuskoodi näyttää tiiviin Shadow DOM -kortin ja lukee vain widgetille kohdistettua julkista JSON-dataa. Se linkittyy takaisin seurantasivuston kanonisiin sivuihin ja välttää tarkistamattoman väitetekstin käyttämistä.
Sivustojen välinen käyttö
Widgetin JSON-päätepisteet ja julkinen entiteettihakupäätepiste sisältävät sallivat CORS-otsikot julkista upottamista ja selainpohjaista hakua varten. Muut julkiset API-päätepisteet pysyvät tavanomaisina saman alkuperän JSON-päätepisteinä, ellei toisin ole dokumentoitu.
Kutsuraja- ja indeksointirobottikäytäntö
Tämä on julkinen kohtuukäyttökäytäntö, ei maksullinen API-SLA.
This is a public fair-use policy, not a paid API SLA. Limits may be enforced or adjusted as traffic grows.