API-referens

Versionerat offentligt dataAPI med skrivskyddad åtkomst

Slutpunkter för citering och sökning av metadata för offentlig policy. Varje JSON-slutpunkt är versionerad under /api/public/v1.

Vad API:et returnerar

Skrivskyddade spårarmetadata: kanoniska postwebbadresser, offentlig JSON, granskningsstatusar, bevisfält, källänkar och citeringsfält.

Vad API:et inte gör

Det ändrar inte poster, publicerar inte mellanlagrade körningar, kringgår inte granskningsstatus och ersätter inte universitetets officiella policykällor.

Rekommenderad hämtning

Slå upp med sökning eller entitetsalias, hämta universitetsregistret och bifoga sedan påståendebevis och käll-URL:er för svar på påståendenivå.

Agent- och API-inriktning

Rekommenderad användning för agenter och dataverktyg.

  • Används för källbaserade sammanfattningar, offentlig JSON, metadata för referenser, granskningsstatus och officiella källänkar.
  • Använd officiella universitetssidor som auktoritativ källa för policyformuleringar.
  • Behandla inte analyser som rådgivning, säkerhetsvägledning eller regelefterlevnad.
  • Matchningar av alias, teman och täckningspoäng skapar inga fakta.
  • Verktygsposter härleds från påstående- och beläggtext; de ersätter inte officiella formuleringar i universitetskällor.

Rekommenderad hämtningsordning

En säker hämtningsordning för agenter som behöver citeringsunderbyggda svar.

Lös enheten

Anrop /api/public/v1/search.json?q=... eller inspektera /api/public/v1/entities/index.json för att hitta universitetets kanoniska slug. Alternativa namnmatchningar förbättrar träffsäkerheten, men de skapar inga fakta.

Step1

Öppna den kanoniska posten

Hämta /api/public/v1/universities/{slug}.json och behåll fälten för kanonisk sid-URL, offentlig JSON-URL, granskningsstatus, datum för senaste kontroll, begränsningar och källhänvisning tillsammans med svaret.

Step2

Bifoga påståendebelägg

Hämta /api/public/v1/claims/{slug}.json när återanvändning på påståendenivå behövs. Bevara källwebbadresser, källspråk, evidensutdrag, hashvärden för ögonblicksbilder, konfidensgrad och granskningsstatus.

Step3

Använd analys som härledda metadata

Hämta /api/public/v1/analysis/universities/{slug}.json endast som deterministiska härledda metadata. Citera alltid underlagets påstående-ID:n och käll-URL:er för icke-tomma analysdimensioner.

Step4

Ändpunktsgrupper

Poster, utgåvor, widgetar, flöden och agentintegrationer.

Discovery

Offentligt API-index med länkar till ändpunkter, tillitssidor, citeringsregler, begränsningar och versionsmetadata.

Universitet

Lista över offentliga universitetsposter med kanonisk sidadress, offentlig JSON-adress, granskningsstatus, datum och antal.

Entitetssökning

Sök offentliga universitetsposter efter kanoniskt namn, alias, officiell källtitel, påståendesammanfattning, källdomän eller analysdimension.

Säkert sökindex

Offentligt sökindex anpassat för Pagefind, utan råa källögonblicksbilder, privata filer, opublicerade mellanlagrade belägg eller kalkylbladsrader utan auktoritativ status.

Index för entitetsmatchning

Alias för kanoniska universitetsentiteter för bättre återfinning. Aliasträffar skapar inga offentliga policyfakta.

Universitetspåståenden

En offentlig universitetsposts påstående- och beläggsrader med källadress, källspråk, ögonblicksbildshash, konfidens och granskningsstatus.

Katalog över AI-verktyg

Härledda poster om universitets AI-verktyg med tillgänglighet per verktyg, typ av institutionellt stöd, granskningsstatus och beläggsutdrag. Verktygsposter är metadata för upptäckt, inte officiella policyslutsatser.

Kvalitet på analyssida

Skrivskyddade kontroller av sidkvalitet, indexerbarhetsstatus, granskningsarbetsflöde för analyser och gränser där inga råd ges för offentliga analyssidor.

QS 2026-täckning

Täckningsrader för QS 2026-mål med fält för offentliga, endast mellanlagrade och saknade poster, källantal, granskningsstatus och nästa åtgärd.

Källornas status

Metadata om käll- och hämtningsstatus för publicerade källögonblicksbilder och mellanlagringskörningar. Används för reparationsplanering, inte publicering av påståenden.

Granskningskö

Metadata för opublicerade mellanlagringskörningar med valideringsstatus, källbredd, identifierade sluggar och rekommenderad nästa åtgärd.

Referensmetadata

Maskinläsbara citeringsmallar, obligatoriska fält, beläggsregler, förbehåll om källrättigheter och gränsen mot rådgivning.

Krav på citering och belägg

Bevara beläggsmodellen när offentliga data återanvänds.

  • Citera den kanoniska sidans URL och den offentliga JSON-URL:en tillsammans.
  • Behåll källans URL, språk, ögonblicksbildhash, bevisutdrag, konfidensgrad och granskningsstatus vid återanvändning av påståenden.
  • Konfidensnivå och granskningsstatus är separata fält.
  • Belägg på originalspråk är normerande.
  • Presentera inte maskinellt framtagna kandidatpåståenden eller påståenden som behöver granskas som slutliga policyslutsatser.
  • Bidragsändpunkter innehåller endast metadata. Offentliga inlämningar skapar granskningsuppgifter via GitHub-mallar för ärenden, inte direkta kanoniska fakta.

Kontrakt för inbäddningsbara widgetar

Offentliga widgetar använder samma API-kontrakt, med CORS aktiverat för inbäddningsbar widget-JSON och entitetssökning.

JavaScript-inbäddning

Inbäddningsskriptet visar ett kompakt kort i Shadow DOM och läser endast widgetspecifik offentlig JSON. Det länkar tillbaka till de kanoniska spårarsidorna och undviker ogranskad påståendetext.

Script/widgets/embed.js

Användning mellan webbplatser

Widget-JSON-slutpunkter och den publika enhetssökningsslutpunkten inkluderar tillåtande CORS-headers för publik inbäddning och webbläsarbaserad uppslagning. Övriga publika API-slutpunkter förblir normal same-origin-JSON om inget annat dokumenteras separat.

CORSWidgets and search

Policy för anropsgränser och sökrobotar

Detta är en offentlig policy för skälig användning, inte ett betalt API-SLA.

Föreslagen gräns
60 requests per minute per client for public JSON usage
Klientcache
3600 minst antal sekunder
Massanvändning
Use dataset release artifacts instead of repeatedly walking per-university endpoints.
Användning av sökrobotar
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.