API-referanse

Versjonert, skrivebeskyttet offentlig data-API

Sitering- og oppslagsendepunkter for offentlige policymetadata. Alle JSON-endepunkter er versjonert under /api/public/v1.

Hva API-et returnerer

Skrivebeskyttede sporingsmetadata: kanoniske oppføringsadresser, offentlig JSON, vurderingsstatuser, bevisfelter, kildelenker og siteringsfelter.

Hva API-et ikke gjør

Den endrer ikke poster, publiserer ikke testkjøringer, omgår ikke gjennomgangsstatus og erstatter ikke offisielle kilder for universitetets retningslinjer.

Anbefalt henting

Løs opp med søk eller enhetsaliaser, hent universitetsoppføringen, og legg deretter ved påstandsbevis og kilde-URL-er for svar på påstandsnivå.

Plassering av agenter og API

Anbefalt bruk for agenter og dataverktøy.

  • Brukes til kildebaserte sammendrag, offentlig JSON, sitatmetadata, gjennomgangsstatus og lenker til offisielle kilder.
  • Bruk offisielle universitetssider som autoritativ kilde for formuleringene i policyen.
  • Ikke behandle analyse som rådgivning, sikkerhetsveiledning eller regeloverholdelse.
  • Treff på alias, temaer og dekningsskårer skaper ikke fakta.
  • Verktøyposter er utledet fra påstands- og evidens-tekst; de erstatter ikke offisiell kildetekst fra universitetet.

Anbefalt hentingsrekkefølge

En trygg innhentingsrekkefølge for agenter som trenger siteringsbelagte svar.

Avklar enheten

Utlysning /api/public/v1/search.json?q=... eller inspiser /api/public/v1/entities/index.json for å finne universitetets kanoniske identifikator. Treff på alias gir bedre gjenfinning, men de skaper ikke fakta.

Step1

Åpne den kanoniske posten

Hent /api/public/v1/universities/{slug}.json og behold feltene for kanonisk side-URL, offentlig JSON-URL, gjennomgangsstatus, dato for siste sjekk, begrensninger og kildehenvisninger sammen med svaret.

Step2

Legg ved påstandsbevis

Hent /api/public/v1/claims/{slug}.json når gjenbruk på påstandsnivå er nødvendig. Bevar kilde-URL-er, kildespråk, bevisutdrag, snapshot-hasher, konfidens og gjennomgangsstatus.

Step3

Bruk analyse som utledede metadata

Hent /api/public/v1/analysis/universities/{slug}.json kun som deterministiske utledede metadata. Oppgi alltid grunnlagets påstands-ID-er og kilde-URL-er for ikke-tomme analysedimensjoner.

Step4

Endepunktgrupper

Poster, utgivelser, widgeter, strømmer og agentintegrasjoner.

Discovery

Offentlig API-indeks med lenker til endepunkter, tillitssider, siteringsregler, begrensninger og versjonsmetadata.

Universiteter

Liste over offentlige universitetsposter med kanonisk side-URL, offentlig JSON-URL, vurderingsstatus, datoer og antall.

Entitetssøk

Søk i offentlige universitetsposter etter kanonisk navn, alias, offisiell kildetittel, påstandssammendrag, kildedomene eller analysedimensjon.

Sikker søkeindeks

Offentlig søkeindeks klargjort for Pagefind, uten rå kildeøyeblikksbilder, private filer, upublisert dokumentasjon fra klargjøringsmiljøet eller regnearkrader uten autoritativ status.

Indeks for entitetsidentifisering

Aliaser for kanoniske universitetsentiteter for bedre gjenfinning. Aliastreff skaper ikke offentlige fakta om retningslinjer.

Universitetsoppføring

Én siteringsklar universitetspost med påstander, dokumentasjonsutdrag, kilde-URL-er, konfidens, vurderingsstatus og rettighetsforbehold.

Påstander om universiteter

Påstands- og dokumentasjonsrader fra én offentlig universitetspost med kilde-URL, kildespråk, øyeblikksbildehash, konfidens og vurderingsstatus.

Katalog over KI-verktøy

Avledede poster om universitetenes KI-verktøy med tilgjengelighet per verktøy, type institusjonell støtte, vurderingsstatus og dokumentasjonsutdrag. Verktøyposter er oppdagelsesmetadata, ikke offisielle konklusjoner om retningslinjer.

Poeng for retningslinjedekning

Liste over dekningspoeng for offentlige analyseprofiler. Poengene måler bredden i offentlig dekning med kildebelegg, ikke kvaliteten på retningslinjene.

Kvalitet på analyseside

Skrivebeskyttede kvalitetskontroller for sider, indekserbarhetsstatus, arbeidsflyt for gjennomgang av analyser og grenser for at det ikke gis råd på offentlige analysesider.

QS 2026-dekning

Dekningsrader for innsamling av QS 2026-mål med felt for offentlige, bare klargjorte og manglende poster, kildeantall, vurderingsstatus og neste handling.

Kildestatus

Metadata om kilde- og innhentingsstatus for publiserte offentlige kildeøyeblikksbilder og klargjøringskjøringer. Brukes til reparasjonsplanlegging, ikke publisering av påstander.

Gjennomgangskø

Metadata for upubliserte klargjøringskjøringer med valideringsstatus, kildebredde, oppdagede slugger og anbefalt neste handling.

MCP-alfamanifest

Skrivebeskyttet MCP-designmanifest med tillatte verktøystrukturer, forbudte handlinger og eksempler på agentspørringer.

Siteringsmetadata

Maskinlesbare siteringsmaler, obligatoriske felt, dokumentasjonsregler, forbehold om kilderettigheter og avgrensning mot rådgivning.

Krav til sitering og dokumentasjon

Bevar dokumentasjonsmodellen ved gjenbruk av offentlige data.

  • Henvis til den kanoniske side-URL-en og den offentlige JSON-URL-en sammen.
  • Behold kilde-URL, språk, øyeblikksbilde-hash, bevisutdrag, konfidens og vurderingsstatus ved gjenbruk av påstand.
  • Sikkerhetsgrad og gjennomgangsstatus er separate felt.
  • Bevis på originalspråket er autoritativt.
  • Presenter ikke maskingenererte kandidater eller påstander som trenger gjennomgang, som endelige konklusjoner om retningslinjer.
  • Bidragsendepunktene inneholder kun metadata. Offentlige innsendinger lager gjennomgangsoppgaver via GitHub-maler for saker, ikke direkte autoritative fakta.

Kontrakt for innebyggbare widgeter

Offentlige widgeter bruker samme API-kontrakt, med CORS aktivert for innebyggbar widget-JSON og entitetssøk.

JavaScript-innbygging

Innbyggingsskriptet viser et kompakt kort i Shadow DOM og leser bare widget-spesifikk offentlig JSON. Det lenker tilbake til de kanoniske sidene i sporingsverktøyet og unngår ugjennomgått påstandstekst.

Script/widgets/embed.js

Bruk på tvers av nettsteder

JSON-endepunkter for moduler (widgets) og det offentlige søkeendepunktet for enheter inkluderer tillatende CORS-headere for offentlig innbygging og nettleserbasert oppslag. Andre offentlige API-endepunkter forblir standard same-origin JSON med mindre annet er dokumentert separat.

CORSWidgets and search

Retningslinjer for anropsgrenser og søkeroboter

Dette er offentlige retningslinjer for rimelig bruk, ikke en betalt API-SLA.

Foreslått grense
60 requests per minute per client for public JSON usage
Klientbuffer
3600 minst sekunder
Bulkbruk
Use dataset release artifacts instead of repeatedly walking per-university endpoints.
Bruk av crawlere
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.