Référence de l'API

API de données publiques versionnée, en lecture seule

Points de terminaison de citation et de recherche pour les métadonnées des politiques publiques. Chaque point de terminaison JSON est versionné sous /api/public/v1.

Ce que renvoie l'API

Métadonnées de suivi en lecture seule : URL de dossiers canoniques, JSON publics, états de révision, champs de preuves, liens vers les sources et champs de citations.

Ce que l'API ne fait pas

Il ne modifie pas les enregistrements, ne publie pas les exécutions de préparation, ne contourne pas l'état de révision et ne remplace pas les sources officielles de politiques de l'université.

Récupération recommandée

Résolvez avec la recherche ou les alias d'entités, récupérez la fiche de l'université, puis joignez les preuves de déclaration et les URL des sources pour les réponses au niveau des déclarations.

Positionnement des agents et de l’API

Utilisation recommandée pour les agents et outils de données.

  • À utiliser pour les résumés fondés sur les sources, le JSON public, les métadonnées de citation, l’état de l’examen et les liens officiels vers les sources.
  • Utilisez les pages officielles de l'université comme référence pour le libellé des politiques.
  • Ne traitez pas l'analyse comme un conseil, une directive de sécurité ou de conformité.
  • Les correspondances d'alias, les thèmes et les scores de couverture ne créent pas de faits.
  • Les enregistrements d'outils sont dérivés des textes d'affirmations et de preuves ; ils ne remplacent pas les formulations des sources officielles de l'université.

Séquence de récupération recommandée

Ordre de récupération sûr pour les agents qui ont besoin de réponses étayées par des citations.

Résoudre l'entité

Appel /api/public/v1/search.json?q=... ou inspecter /api/public/v1/entities/index.json pour trouver le slug canonique de l'université. Les correspondances par alias améliorent le rappel, mais ne créent pas de faits.

Step1

Ouvrir la fiche de référence

Récupérer /api/public/v1/universities/{slug}.json et conserver l'URL canonique de la page, l'URL publique du JSON, l'état de l'examen, la date de dernière vérification, les limites et les champs de citation avec la réponse.

Step2

Joindre les preuves de la déclaration

Récupérer /api/public/v1/claims/{slug}.json lorsqu'une réutilisation au niveau des affirmations est nécessaire. Conservez les URL sources, la langue source, les extraits de preuves, les empreintes (hachages) des instantanés, le niveau de confiance et l'état de révision.

Step3

Utiliser l'analyse comme métadonnée dérivée

Récupérer /api/public/v1/analysis/universities/{slug}.json uniquement en tant que métadonnées dérivées déterministes. Citez toujours les ID des déclarations de base et les URL des sources pour les dimensions d'analyse non vides.

Step4

Familles de points d’accès

Fiches, publications, widgets, flux et intégrations d’agents.

Discovery

Index de l’API publique avec liens vers les points d’accès, pages de confiance, règles de citation, limites et métadonnées de version.

Universités

Liste des fiches universitaires publiques avec URL de page canonique, URL du JSON public, état de révision, dates et décomptes.

Recherche d’entités

Rechercher dans les fiches universitaires publiques par nom canonique, alias, titre de source officielle, résumé d’affirmation, domaine source ou dimension d’analyse.

Index de recherche sécurisé

Index de recherche public prêt pour Pagefind, excluant les instantanés de sources brutes, les fichiers privés, les preuves en préparation non publiées et les lignes de tableur non autoritatives.

Index de résolution d’entités

Alias canoniques d’entités universitaires pour améliorer le rappel. Une correspondance d’alias ne crée aucun fait public sur les politiques.

Dossier de l'université

Une fiche universitaire prête à citer, avec affirmations, extraits de preuves, URL des sources, niveau de confiance, état de révision et réserves sur les droits.

Affirmations universitaires

Lignes d’affirmations et de preuves d’une fiche universitaire publique, avec URL source, langue source, empreinte de l’instantané, niveau de confiance et état de révision.

Répertoire des outils d'IA

Fiches dérivées d’outils d’IA universitaires avec disponibilité de chaque outil, type d’approbation, état de révision et extraits de preuves. Ces fiches sont des métadonnées de découverte, pas des conclusions de politique officielle.

Index de l'API d'analyse

Dimensions déterministes d’analyse des politiques, chemins des points d’accès, limites et métadonnées de version du schéma.

Profil d'analyse de l'université

Profil d’analyse étayé par des sources avec dimensions, identifiants d’affirmations probantes, URL sources, niveau de confiance, état de révision et score de couverture des politiques.

Scores de couverture des politiques

Liste des scores de couverture pour les profils d'analyse publics. Les scores mesurent l'étendue de la couverture publique documentée par des sources, et non la qualité de la politique.

Qualité de la page d'analyse

Contrôles de qualité des pages en lecture seule, statut d'indexabilité, flux de révision des analyses et limites excluant toute forme de conseil pour les pages d'analyse publiques.

Couverture QS 2026

Lignes de couverture de collecte des cibles QS 2026 avec champs public, en préparation uniquement, manquant, nombre de sources, état de révision et prochaine action.

État des sources

Métadonnées de santé des sources et des récupérations pour les instantanés de sources rendus publics et les exécutions en préparation. Utilisées pour planifier les corrections, pas pour publier des affirmations.

File d'attente d'examen

Métadonnées d’exécutions en préparation non publiées avec état de validation, diversité des sources, identifiants d’URL détectés et prochaine action recommandée.

Publication de jeu de données

Manifeste de publication avec artefacts, nombres de lignes, tailles en octets, sommes de contrôle SHA-256, citation et limites.

Index des rapports

Index de rapports lisibles par machine comportant les URL des rapports, des indicateurs, des liens vers les données, des flux et des éléments de découverte pour la diffusion.

Kit de diffusion des rapports

Textes lisibles par machine pour les médias, lettres d’information, courriels aux chercheurs et réseaux sociaux, avec limites d’utilisation explicites.

Manifeste alpha MCP

Manifeste de conception MCP en lecture seule avec structures d’outils autorisées, actions interdites et exemples de requêtes d’agents.

Catalogue des outils MCP

Catalogue d’outils MCP alpha en lecture seule avec schémas d’entrée, champs de sortie obligatoires et modifications strictement interdites.

Politique de limitation de débit

Politique publique d’utilisation équitable lisible par machine pour l’accès à l’API, aux widgets et aux robots d’exploration.

Métadonnées de citation

Modèles de citation lisibles par machine, champs obligatoires, règles de preuve, réserve sur les droits des sources et limites excluant tout conseil.

Exigences de citation et de preuve

Préserver le modèle de preuve lors de la réutilisation des données publiques.

  • Citez conjointement l'URL de la page canonique et l'URL publique du JSON.
  • Conserver l'URL source, la langue, le hachage de l'instantané, l'extrait de preuve, le niveau de confiance et l'état de révision lors de la réutilisation de l'affirmation.
  • Le niveau de confiance et l'état d'examen sont des champs distincts.
  • Les éléments de preuve dans la langue originale font foi.
  • Ne présentez pas comme conclusions définitives les affirmations générées automatiquement ou nécessitant un examen.
  • Les points de terminaison des contributions ne contiennent que des métadonnées. Les soumissions publiques créent des tâches de relecture via les modèles de tickets GitHub, et non des faits canoniques directs.

Contrat des widgets intégrables

Les widgets publics utilisent le même contrat API, avec CORS activé pour le JSON des widgets intégrables et la recherche d’entités.

Intégration JavaScript

Le script d'intégration affiche une carte compacte en Shadow DOM et ne lit que le JSON public propre au widget. Il renvoie vers les pages canoniques du suivi et évite les textes de déclarations non examinées.

Script/widgets/embed.js

Utilisation inter-sites

Les points de terminaison JSON des widgets et le point de terminaison public de recherche d'entités incluent des en-têtes CORS permissifs pour l'intégration publique et la recherche depuis le navigateur. Les autres points de terminaison de l'API publique restent des réponses JSON de même origine, sauf indication contraire documentée séparément.

CORSWidgets and search

Politique de limitation de débit et d’exploration

Il s’agit d’une politique publique d’utilisation équitable, pas d’un accord de niveau de service d’API payante.

Limite suggérée
60 requests per minute per client for public JSON usage
Cache client
3600 secondes minimum
Utilisation en masse
Use dataset release artifacts instead of repeatedly walking per-university endpoints.
Utilisation des robots d'exploration
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.