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ă.
Folosește tastele Săgeată stânga și Săgeată dreapta pentru a parcurge întregul conținut orizontal.
| 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.
Folosește tastele Săgeată stânga și Săgeată dreapta pentru a parcurge întregul conținut orizontal.
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.
Folosește tastele Săgeată stânga și Săgeată dreapta pentru a parcurge întregul conținut orizontal.
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.