Intelligence structurée
Interrogez les fiches de gouvernance étayées par des sources depuis le même graphe de connaissances rendu en périphérie que la plateforme publique.
Points de terminaison
Tous les points de terminaison v1 sont rendus en périphérie Cloudflare et exigent une clé API active avec le droit indiqué.
| Méthode | Point de terminaison | Droit | Résultat |
|---|---|---|---|
GET | /api/v1/countries | countries:read | Catalogue paginé des pays avec les derniers champs publiés de l’Indice. |
GET | /api/v1/countries/{country} | countries:read | Profil d’un pays identifié par son URL, son nom, son code ISO alpha-2, alpha-3 ou numérique. |
GET | /api/v1/index/2026 | index:read | Édition de l’Indice, dimensions méthodologiques, résultats et sources de preuves. |
GET | /api/v1/observatory | observatory:read | Chronologie vérifiée, prochaines échéances, législation et couverture. |
GET | /api/v1/search?q={query} | catalog:read | Recherche complète dans le graphe de connaissances parmi les entités publiées. |
GET | /api/v1/reports/{slug} | reports:read | Contenu du rapport, méthodologie, graphiques, références et URL du PDF. |
Authentification
Envoyez la clé API dans l’en-tête Authorization. Les réponses API incluent les en-têtes de quota du jour et de la minute en cours.
curl --request GET \
--url "https://aigovernanceworld.com/api/v1/countries?page=1&pageSize=50" \
--header "Authorization: Bearer agw_live_YOUR_KEY"Route publique des pays
La route des pays compatible avec le Blueprint est publique, en lecture seule et mise en cache en périphérie. Elle accepte les mêmes identifiants de pays que la v1.
curl --request GET \
--url "https://aigovernanceworld.com/country/RO"Contrat de réponse
Les collections acceptent page et pageSize ; la taille de page est limitée à 100. Les listes de pays acceptent aussi q, region et rankedOnly. La recherche exige une requête de 2 à 120 caractères.
Les réponses réussies présentent les données demandées avec la version de l’API, l’heure de génération, les états de publication et de vérification, les liens de pagination et la politique des sources. Les fiches conservent l’URL de leur source primaire, le niveau de preuve et la date de la source.
Les erreurs utilisent application/problem+json. Les limites de débit renvoient HTTP 429 avec un en-tête Retry-After. Le vocabulaire d’autorisation disponible est catalog:read, countries:read, index:read, sources:read, observatory:read, reports:read.