Informații structurate
Interoghează înregistrări de guvernanță susținute de surse din același graf de cunoștințe randat la edge care alimentează platforma publică.
Endpoint-uri
Toate endpoint-urile v1 sunt randate la edge prin Cloudflare și necesită o cheie API activă cu permisiunea indicată.
| Metodă | Endpoint | Permisiune | Returnează |
|---|---|---|---|
GET | /api/v1/countries | countries:read | Catalog paginat al țărilor, cu cele mai recente câmpuri publicate ale Indexului. |
GET | /api/v1/countries/{country} | countries:read | Profil de țară identificat după slug, nume, cod ISO alfa-2, alfa-3 sau numeric. |
GET | /api/v1/index/2026 | index:read | Ediția Indexului, dimensiunile metodologiei, rezultatele și sursele dovezilor. |
GET | /api/v1/observatory | observatory:read | Cronologie verificată, termene viitoare, legislație și acoperire. |
GET | /api/v1/search?q={query} | catalog:read | Căutare completă în graful de cunoștințe printre entitățile publicate. |
GET | /api/v1/reports/{slug} | reports:read | Conținutul raportului, metodologia, graficele, referințele și adresa PDF-ului. |
Autentificare
Trimite cheia API în antetul Authorization. Răspunsurile API includ antete privind cota pentru ziua și minutul curente.
curl --request GET \
--url "https://aigovernanceworld.com/api/v1/countries?page=1&pageSize=50" \
--header "Authorization: Bearer agw_live_YOUR_KEY"Ruta publică pentru țări
Ruta de țară compatibilă cu Blueprint este publică, doar pentru citire și memorată în cache la edge. Acceptă aceiași identificatori de țară ca v1.
curl --request GET \
--url "https://aigovernanceworld.com/country/RO"Contractul răspunsului
Endpoint-urile de colecție acceptă page și pageSize; dimensiunea paginii este limitată la 100. Listele de țări acceptă și q, region și rankedOnly. Căutarea necesită o interogare de 2 până la 120 de caractere.
Răspunsurile reușite prezintă datele solicitate împreună cu versiunea API, ora generării, starea publicării și verificării, linkurile de paginare și politica surselor. Înregistrările păstrează URL-ul sursei primare, nivelul dovezii și data sursei.
Erorile folosesc application/problem+json. Limitările de frecvență returnează HTTP 429 cu antetul Retry-After. Vocabularul disponibil pentru autorizare este catalog:read, countries:read, index:read, sources:read, observatory:read, reports:read.