Cosa restituisce l'API
Metadati del tracker in sola lettura: URL canonici dei record, JSON pubblici, stati di revisione, campi delle prove, link alle fonti e campi delle citazioni.
Riferimento API
API pubblica di dati in sola lettura con versioni
Endpoint di citazione e ricerca per i metadati delle politiche pubbliche. Ogni endpoint JSON è versionato sotto /api/public/v1.
Che cosa non fa l'API
Non modifica i record, non pubblica esecuzioni di staging, non aggira lo stato di revisione né sostituisce le fonti ufficiali delle politiche dell'ateneo.
Recupero consigliato
Risolvere con la ricerca o gli alias di entità, recuperare il record dell'università, quindi allegare le prove delle asserzioni e gli URL delle fonti per risposte a livello di asserzione.
Posizionamento degli agenti e dell'API
Uso consigliato per agenti e strumenti dati.
- Uso per sintesi basate sulle fonti, JSON pubblico, metadati di citazione, stato di revisione e collegamenti alle fonti ufficiali.
- Usare le pagine ufficiali dell'università come riferimento per il linguaggio delle politiche.
- Non considerare l'analisi come una consulenza, un'indicazione di sicurezza o una verifica di conformità.
- Le corrispondenze di alias, i temi e i punteggi di copertura non creano fatti.
- I record degli strumenti derivano dal testo delle affermazioni e delle prove; non sostituiscono il linguaggio delle fonti universitarie ufficiali.
Sequenza di recupero consigliata
Un ordine di recupero sicuro per gli agenti che richiedono risposte supportate da citazioni.
Risolvere l'entità
Chiamata /api/public/v1/search.json?q=... o ispeziona /api/public/v1/entities/index.json per trovare lo slug canonico dell'università. Le corrispondenze per alias migliorano il recupero, ma non creano fatti.
Apri il record canonico
Recupera /api/public/v1/universities/{slug}.json e mantenere i campi URL canonico della pagina, URL JSON pubblico, stato di revisione, data dell'ultimo controllo, limitazioni e citazione insieme alla risposta.
Allega prova dell'affermazione
Recupera /api/public/v1/claims/{slug}.json quando è necessario riutilizzare a livello di singola affermazione. Conservare URL delle fonti, lingua della fonte, estratti di prova, hash degli snapshot, livello di confidenza e stato di revisione.
Utilizzare l'analisi come metadati derivati
Recupera /api/public/v1/analysis/universities/{slug}.json solo come metadati derivati deterministici. Citare sempre gli ID delle asserzioni di base e gli URL delle fonti per le dimensioni di analisi non vuote.
Famiglie di endpoint
Record, pubblicazioni, widget, feed e integrazioni con agenti.
Discovery
Indice API pubblico con collegamenti agli endpoint, pagine sull'affidabilità, regole di citazione, limitazioni e metadati di versione.
Università
Elenco dei record universitari pubblici con URL canonico della pagina, URL del JSON pubblico, stato di revisione, date e conteggi.
Ricerca di entità
Cerca nei record universitari pubblici per nome canonico, alias, titolo della fonte ufficiale, riepilogo dell'affermazione, dominio della fonte o dimensione di analisi.
Indice di ricerca sicuro
Indice di ricerca pubblico predisposto per Pagefind, esclusi gli snapshot grezzi delle fonti, i file privati, le evidenze di staging non pubblicate e le righe di fogli di calcolo non autorevoli.
Indice di risoluzione delle entità
Alias delle entità universitarie canoniche per migliorare il reperimento. Le corrispondenze con gli alias non creano fatti pubblici sulle politiche.
Record universitario
Un record universitario pronto per la citazione con affermazioni, estratti di evidenze, URL delle fonti, livello di confidenza, stato di revisione e avvertenze sui diritti.
Affermazioni sulle università
Righe di affermazioni ed evidenze di un record universitario pubblico con URL e lingua della fonte, hash dello snapshot, livello di confidenza e stato di revisione.
Directory degli strumenti di IA
Record derivati sugli strumenti di IA universitari con disponibilità per strumento, tipo di approvazione istituzionale, stato di revisione ed estratti di evidenze. I record sugli strumenti sono metadati di reperimento, non conclusioni ufficiali sulle politiche.
Modifiche recenti
Verifiche pubbliche recenti delle fonti e record istituzionali modificati.
Indice dell'API di analisi
Dimensioni deterministiche di analisi delle politiche, percorsi degli endpoint, limitazioni e metadati di versione dello schema.
Profilo di analisi dell'università
Profilo di analisi basato sulle fonti con dimensioni, ID delle affermazioni probatorie, URL delle fonti, livello di confidenza, stato di revisione e punteggio di copertura delle politiche.
Punteggi di copertura delle politiche
Elenco dei punteggi di copertura per i profili di analisi pubblici. I punteggi misurano l'ampiezza della copertura pubblica supportata da fonti, non la qualità della politica.
Qualità della pagina di analisi
Controlli di qualità in sola lettura delle pagine, stato di indicizzabilità, flusso di revisione delle analisi e limiti di assenza di consulenza per le pagine di analisi pubbliche.
Copertura QS 2026
Righe di copertura della raccolta per gli obiettivi QS 2026 con campi per record pubblici, solo in staging e mancanti, numero di fonti, stato di revisione e prossima azione.
Stato delle fonti
Metadati sullo stato delle fonti e del recupero per snapshot di fonti pubbliche pubblicati ed esecuzioni di staging. Usati per pianificare le correzioni, non per pubblicare affermazioni.
Coda di revisione
Metadati delle esecuzioni di staging non pubblicate con stato di validazione, ampiezza delle fonti, slug rilevati e prossima azione consigliata.
Rilascio del dataset
Manifesto di pubblicazione con artefatti, numero di righe, dimensioni in byte, checksum SHA-256, citazione e limitazioni.
Indice dei rapporti
Indice leggibile da macchina dei report, con URL dei report, metriche, link ai dati, feed e individuazione per le attività di sensibilizzazione.
Dati del grafico del rapporto
Distribuzioni pronte per i grafici su lingua delle fonti, stato di revisione, copertura regionale, di città e campus e delle classifiche per l'ultimo rapporto mensile.
Pacchetto di divulgazione dei rapporti
Testi leggibili dalle macchine per media, newsletter, email ai ricercatori e social con limiti d'uso espliciti.
Indice dei widget
Dati di individuazione dei widget con URL dello script, widget supportati, vincoli ed esempio HTML.
Widget sullo stato dell'università
Dati compatti del widget con aggiornamento, stato di revisione, conteggi di affermazioni e fonti e collegamenti canonici.
Widget delle modifiche recenti
Dati compatti sulle modifiche recenti per i widget delle verifiche pubbliche delle fonti e delle modifiche.
Widget di copertura delle politiche
Dati compatti del widget sulla copertura delle politiche, basati sulle fonti. La copertura indica ampiezza, non qualità delle politiche.
Widget di aggiornamento delle fonti
Dati compatti del widget sull'aggiornamento delle fonti con data dell'ultima verifica, numero di fonti e conteggi pubblici sul loro stato.
Widget di stato di revisione
Dati compatti del widget sullo stato di revisione con livello di confidenza e conteggi delle affermazioni revisionate e candidate.
Manifesto MCP alfa
Manifesto progettuale MCP in sola lettura con strutture degli strumenti consentite, azioni vietate ed esempi di richieste degli agenti.
Catalogo degli strumenti MCP
Catalogo degli strumenti MCP alfa in sola lettura con schemi di input, campi di output obbligatori e modifiche tassativamente vietate.
Politica sui limiti di richieste
Politica pubblica leggibile dalle macchine per l'uso equo dell'accesso tramite API, widget e crawler.
Metadati di citazione
Modelli di citazione leggibili dalle macchine, campi obbligatori, regole sulle evidenze, avvertenza sui diritti delle fonti e confine rispetto alla consulenza.
Indice di contributo
Metadati in sola lettura sul flusso dei contributi, URL dei modelli di issue GitHub, salvaguardie e regole di pubblicazione.
Politica di revisione dei contributi
Definizioni in sola lettura delle code di revisione, limiti della moderazione e criteri di ammissione alla pubblicazione.
Requisiti di citazione ed evidenza
Preserva il modello delle evidenze quando riutilizzi i dati pubblici.
- Cita l'URL canonico della pagina e l'URL JSON pubblico congiuntamente.
- Mantieni l'URL di origine, la lingua, l'hash dello snapshot, lo snippet della prova, il livello di confidenza e lo stato di revisione con il riutilizzo dell'asserzione.
- Il livello di affidabilità e lo stato di revisione sono campi distinti.
- Le prove nella lingua originale fanno fede.
- Non presentare affermazioni candidate generate automaticamente o che richiedono revisione come conclusioni definitive sulle politiche.
- Gli endpoint di contributo contengono solo metadati. Le proposte pubbliche generano attività di revisione tramite i modelli di issue di GitHub, non fatti canonici diretti.
Contratto dei widget incorporabili
I widget pubblici usano lo stesso contratto API, con CORS abilitato per il JSON dei widget incorporabili e la ricerca di entità.
Incorporamento JavaScript
Lo script di incorporamento genera una scheda compatta in Shadow DOM e legge solo il JSON pubblico specifico del widget. Rimanda alle pagine canoniche del tracker ed evita il testo delle affermazioni non ancora esaminato.
Uso tra siti
Gli endpoint JSON del widget e l'endpoint di ricerca pubblica delle entità includono intestazioni CORS permissive per l'incorporamento pubblico e la ricerca basata su browser. Gli altri endpoint API pubblici restano normali endpoint JSON same-origin a meno che non sia documentato separatamente.
Politica sui limiti di richieste e sui crawler
Questa è una politica pubblica di uso equo, non uno SLA API a pagamento.
This is a public fair-use policy, not a paid API SLA. Limits may be enforced or adjusted as traffic grows.