API-reference

Versioneret, skrivebeskyttet offentligt data-API

Endpoints til citering og opslag af metadata for offentlige politikker. Hvert JSON-endpoint er versioneret under /api/public/v1.

Hvad API'en returnerer

Skrivebeskyttede sporingsmetadata: kanoniske URL'er for poster, offentlig JSON, gennemgangsstatusser, bevisfelter, kildelinks og citeringsfelter.

Hvad API'en ikke gør

Det ændrer ikke poster, offentliggør ikke staging-kørsler, omgår ikke gennemgangsstatus og erstatter ikke universitetets officielle politikkilder.

Anbefalet hentning

Løs via søgning eller entitetsaliasser, hent universitetsposten, og vedhæft derefter påstandsdokumentation og kilde-URL'er for svar på påstandsniveau.

Agent- og API-positionering

Anbefalet brug for agenter og dataværktøjer.

  • Anvendes til kildebaserede resuméer, offentlig JSON, metadata til citationer, gennemgangsstatus og officielle kildelinks.
  • Brug officielle universitetssider som autoritet for politikformuleringer.
  • Behandl ikke analyse som rådgivning, sikkerhedsvejledning eller compliance.
  • Aliasmatch, temaer og dækningsscorer skaber ikke fakta.
  • Værktøjsregistreringer er afledt af påstands- og bevistekst; de erstatter ikke det officielle kildesprog fra universitetet.

Anbefalet hentningsrækkefølge

En sikker hentningsrækkefølge for agenter, der behøver citationsunderbyggede svar.

Identificér enheden

Kald /api/public/v1/search.json?q=... eller inspicer /api/public/v1/entities/index.json for at finde det kanoniske universitets-slug. Aliasmatches forbedrer genfindingen, men skaber ikke fakta.

Step1

Åbn den kanoniske registrering

Hent /api/public/v1/universities/{slug}.json og behold den kanoniske side-URL, offentlige JSON-URL, gennemgangsstatus, dato for seneste kontrol, begrænsninger og citationsfelter sammen med svaret.

Step2

Vedhæft påstandsbevis

Hent /api/public/v1/claims/{slug}.json når genbrug på påstandsniveau er nødvendigt. Bevar kilde-URL’er, kildesprog, evidensuddrag, snapshot-hashes, konfidens og gennemgangsstatus.

Step3

Anvend analyse som udledte metadata

Hent /api/public/v1/analysis/universities/{slug}.json kun som deterministiske udledte metadata. Citer altid grundlagets påstands-ID'er og kilde-URL'er for ikke-tomme analysedimensioner.

Step4

Endepunktsgrupper

Poster, udgivelser, widgets, feeds og agentintegrationer.

Discovery

Offentligt API-indeks med links til endepunkter, tillidssider, citationsregler, begrænsninger og versionsmetadata.

Universiteter

Liste over offentlige universitetsposter med kanonisk side-URL, offentlig JSON-URL, gennemgangsstatus, datoer og antal.

Entitetssøgning

Søg i offentlige universitetsposter efter kanonisk navn, alias, officiel kildetitel, udsagnsresumé, kildedomæne eller analysedimension.

Sikkert søgeindeks

Offentligt søgeindeks klar til Pagefind, uden rå kildeøjebliksbilleder, private filer, ikke-publiceret mellemstadieevidens eller regnearksrækker uden autoritativ status.

Indeks til entitetsidentifikation

Aliasser for kanoniske universitetsentiteter til bedre genfinding. Aliasmatch skaber ikke offentlige politikfakta.

Universitetsudsagn

Udsagns- og evidensrækker fra én offentlig universitetspost med kilde-URL, kildesprog, øjebliksbilledhash, konfidens og gennemgangsstatus.

Katalog over AI-værktøjer

Afledte poster om universiteters AI-værktøjer med tilgængelighed på værktøjsniveau, type af institutionel tilslutning, gennemgangsstatus og evidensuddrag. Værktøjsposter er opdagelsesmetadata, ikke officielle politikkonklusioner.

Kvalitet af analyseside

Skrivebeskyttede kvalitetskontroller af sider, indekserbarhedsstatus, arbejdsgang for analysegennemgang og grænser for, hvad der ikke udgør rådgivning, på offentlige analysesider.

QS 2026-dækning

Dækningsrækker for QS 2026-mål med felter for offentlige, kun mellemstadie- og manglende poster, kildeantal, gennemgangsstatus og næste handling.

Kildernes status

Metadata om kilde- og hentningsstatus for publicerede offentlige kildeøjebliksbilleder og mellemstadiekørsler. Bruges til reparationsplanlægning, ikke til publicering af udsagn.

Gennemgangskø

Metadata for ikke-publicerede mellemstadiekørsler med valideringsstatus, kildebredde, registrerede slugs og anbefalet næste handling.

MCP-alfamanifest

Skrivebeskyttet MCP-designmanifest med tilladte værktøjsformer, forbudte handlinger og eksempler på agentforespørgsler.

Citationsmetadata

Maskinlæsbare citationsskabeloner, obligatoriske felter, evidensregler, forbehold om kilderettigheder og grænse mod rådgivning.

Krav til citation og evidens

Bevar evidensmodellen ved genbrug af offentlige data.

  • Citér den kanoniske side-URL og den offentlige JSON-URL sammen.
  • Bevar kildens URL, sprog, snapshot-hash, evidensuddrag, konfidens og gennemgangsstatus ved genbrug af påstande.
  • Tillidsniveau og gennemgangsstatus er separate felter.
  • Dokumentation på originalsproget er autoritativ.
  • Præsenter ikke maskinelt foreslåede påstande eller påstande, der kræver gennemgang, som endelige politikkonklusioner.
  • Bidragsendepunkter er kun metadata. Offentlige indsendelser opretter gennemgangsopgaver via GitHub-skabeloner til issues, ikke direkte kanoniske fakta.

Kontrakt for widgets til indlejring

Offentlige widgets bruger samme API-kontrakt med CORS aktiveret til indlejret widget-JSON og entitetssøgning.

JavaScript-integrering

Embed-scriptet gengiver et kompakt Shadow DOM-kort og læser kun widgetspecifik offentlig JSON. Det linker tilbage til de kanoniske sider i trackeren og undgår tekst om påstande, der ikke er gennemgået.

Script/widgets/embed.js

Brug på tværs af websteder

Widget-JSON-slutpunkter og det offentlige entitetssøgningsslutpunkt inkluderer permissive CORS-headere til offentlig indlejring og browserbaseret opslag. Andre offentlige API-slutpunkter forbliver normal same-origin-JSON, medmindre andet er dokumenteret særskilt.

CORSWidgets and search

Politik for kaldsgrænser og crawlere

Dette er en offentlig politik for rimelig brug, ikke en betalt API-SLA.

Foreslået grænse
60 requests per minute per client for public JSON usage
Klientcache
3600 sekunder minimum
Masseanvendelse
Use dataset release artifacts instead of repeatedly walking per-university endpoints.
Brug af 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.