Inteligencia estructurada
Consulta registros de gobernanza respaldados por fuentes desde el mismo grafo de conocimiento renderizado en el edge que impulsa la plataforma pública.
Puntos de acceso
Todos los puntos de acceso v1 se renderizan en el edge de Cloudflare y requieren una clave API activa con el permiso indicado.
| Método | Punto de acceso | Permiso | Devuelve |
|---|---|---|---|
GET | /api/v1/countries | countries:read | Catálogo paginado de países con los últimos campos publicados del Índice. |
GET | /api/v1/countries/{country} | countries:read | Perfil de país resuelto por identificador URL, nombre, código ISO alfa-2, alfa-3 o numérico. |
GET | /api/v1/index/2026 | index:read | Edición del Índice, dimensiones metodológicas, resultados y fuentes de evidencia. |
GET | /api/v1/observatory | observatory:read | Cronología verificada, próximos plazos, legislación y cobertura. |
GET | /api/v1/search?q={query} | catalog:read | Búsqueda completa en el grafo de conocimiento entre entidades publicadas. |
GET | /api/v1/reports/{slug} | reports:read | Contenido del informe, metodología, gráficos, referencias y URL del PDF. |
Autenticación
Envía la clave API en la cabecera Authorization. Las respuestas de la API incluyen cabeceras de cuota para el día y el minuto actuales.
curl --request GET \
--url "https://aigovernanceworld.com/api/v1/countries?page=1&pageSize=50" \
--header "Authorization: Bearer agw_live_YOUR_KEY"Ruta pública de países
La ruta de países compatible con el Blueprint es pública, de solo lectura y se almacena en caché en el edge. Acepta los mismos identificadores de país que la v1.
curl --request GET \
--url "https://aigovernanceworld.com/country/RO"Contrato de respuesta
Los puntos de colección aceptan page y pageSize; el tamaño de página está limitado a 100. Las listas de países también aceptan q, region y rankedOnly. La búsqueda requiere una consulta de entre 2 y 120 caracteres.
Las respuestas correctas muestran los datos solicitados junto con la versión de la API, la hora de generación, los estados de publicación y verificación, los enlaces de paginación y la política de fuentes. Los registros conservan la URL de su fuente primaria, el nivel de evidencia y la fecha de la fuente.
Los errores utilizan application/problem+json. Los límites de frecuencia devuelven HTTP 429 con una cabecera Retry-After. El vocabulario de autorización disponible es catalog:read, countries:read, index:read, sources:read, observatory:read, reports:read.