Sursă publică unică
Paginile și API-ul folosesc aceleași filtre, inclusiv căutarea tolerantă la diacritice.
Reutilizare · contract stabil v1.0
API public și exporturi open data
Datele aprobate pentru publicare sunt disponibile prin endpoint-uri versionate, cu aceeași structură în JSON și CSV, paginare deterministă și erori ușor de procesat automat.
JSON și CSV
Colecțiile pot fi descărcate prin format=csv sau antetul Accept.
Utilizare responsabilă
Limită distribuită de 120/60s la origine, antete standard și Retry-After.
Endpoint-uri v1
Toate rutele acceptă GET și OPTIONS. Colecțiile au page, pageSize, sort, order și format.
| Metodă | Rută | Scop | Formate |
|---|---|---|---|
| GET | /api/v1 | Descoperirea versiunii și a resurselor API | json |
| GET | /api/v1/institutions | Catalogul instituțiilor publice | json · csv |
| GET | /api/v1/search | Căutare unificată în toate resursele publice | json · csv |
| GET | /api/v1/publications | Registrul publicărilor aprobate | json · csv |
| GET | /api/v1/publications/{slug} | Publicare și istoric de versiuni | json |
| GET | /api/v1/publications/{slug}/export | Pachet portabil al publicării și istoricului complet | json |
| GET | /api/v1/obligations | Registrul public versionat al obligațiilor de publicare | json · csv |
| GET | /api/v1/obligations/{code} | Fișa obligației, istoricul și neclaritățile metodologice publicate | json |
| GET | /api/v1/consultations | Consultări publice și calendar | json · csv |
| GET | /api/v1/consultations/{slug} | Dosarul public al unei consultări | json |
| GET | /api/v1/consultations/annual-report | Indicatori agregați pentru raportarea anuală a transparenței decizionale | json · csv |
| GET | /api/v1/information-requests | Răspunsuri anonimizate și indicatori agregați | json · csv |
| GET | /api/v1/time-series | Serii lunare longitudinale și metadate metodologice | json · csv |
| GET | /api/v1/monitoring | Măsurări naționale versionate și cohorte comparabile | json · csv |
| GET | /api/v1/indicator-definitions | Definițiile versionate ale indicatorilor SGG și modelul lor operațional | json · csv |
| GET | /api/v1/indicators | Măsurători agregate demonstrative pe instituție | json · csv |
| GET | /api/v1/compliance | Evaluări reproductibile și agregări de conformitate | json · csv |
| GET | /api/v1/openapi | Specificația OpenAPI 3.1 citibilă de mașini | json |
| GET | /api/v1/snpd/schema | Schema JSON SNPD 1.0.0-draft pentru o publicare canonică | json |
Exemple
Registrul obligațiilor
GET /api/v1/obligations?q=buget&profile=local_administration&pageSize=25Filtrare și paginare JSON
GET /api/v1/publications?q=buget&institution=municipiul-nova&page=1&pageSize=25&sort=publishedAt&order=descExport CSV
GET /api/v1/compliance?dataset=evaluations&state=overdue&format=csvNegocierea formatului
curl -H 'Accept: text/csv' 'https://domeniu.example/api/v1/institutions?pageSize=100'Contractul răspunsului
Succesul conține data și meta. Erorile folosesc application/problem+json, un cod stabil, status HTTP și requestId pentru diagnostic.
CSV folosește UTF-8 cu BOM, antete stabile în snake_case și aceleași rânduri după filtrare, sortare și paginare.
Licență: CC BY 4.0
Datele pot fi copiate, redistribuite și adaptate cu atribuirea sursei. Datele demonstratorului sunt fictive și nu au caracter oficial.
Textul licențeiProtecție în straturi
Limitare, corelare și obiective de serviciu
Limită distribuită
120 cereri în 60 de secunde pentru fiecare identitate tehnică pseudonimizată. Contorul PostgreSQL este atomic; fallbackul local este semnalat în loguri.
Diagnostic fără date personale
X-Request-ID corelează execuția la origine, x-vercel-id cererea la edge, iar X-Response-Time publică durata aplicației care a produs reprezentarea.
Ținte măsurabile
Disponibilitate 99.9% și latență la origine p95 sub 1 secundă. Acestea sunt ținte ale demonstratorului, nu un SLA contractual.
Vercel aplică protecția DDoS înaintea aplicației, CDN-ul absoarbe cererile cache-uite, iar limiterul distribuit protejează originea. Pentru pilot, regula WAF care acoperă și cache hit-urile se activează separat, mai întâi în mod de observare.
Status: stable
Politica de evoluție și depreciere
Schimbări compatibile
Putem adăuga rute, câmpuri opționale, filtre sau formate. Nu eliminăm și nu reinterpretăm angajamentele v1.
Schimbări incompatibile
Eliminarea ori schimbarea semantică necesită o versiune majoră nouă, rută separată și ghid de migrare.
Preaviz minim
Deprecierea este anunțată cu minimum 180 de zile înaintea retragerii, prin changelog, documentație și antetele Deprecation, Sunset și Link.
O excepție poate scurta termenul numai pentru o obligație legală ori o vulnerabilitate critică; motivul, impactul și alternativa se publică în changelog. Deprecierea nu schimbă comportamentul resursei înainte de Sunset.
Changelog API
Modificările sunt publicate în ordine cronologică inversă și clasificate după impactul asupra clienților.
v1.0 · compatible
Widgeturi și export portabil fără captivitate
Adaugă widgeturi progresive pentru lista și fișa publicării, fallback semantic fără JavaScript și un pachet JSON versionat cu istoricul complet, politica de retragere și schema deschisă. Contractul v1 rămâne aditiv.
v1.0 · compatible
Publicare unică asistată pentru instituții mici
Fișa unei publicări poate include aditiv payloadul structurat validat, istoricul versiunilor și monitorul distribuției către pagina persistentă, API, căutare și monitorizare. Datele și domeniile rămân exclusiv fictive.
v1.0 · compatible
Căutare națională și monitorizare comparabilă
Adaugă un index unificat pentru instituții, obligații, publicări și consultări, plus măsurări care separă definiția, valoarea, scorul, proveniența și verificarea. Exporturile păstrează stările semantice și cheia cohortelor comparabile.
v1.0 · compatible
Registrul obligațiilor și schema SNPD demonstrativă
Adaugă registrul public versionat al obligațiilor în JSON/CSV, fișele și istoricul lor, plus schema machine-readable SNPD 1.0.0-draft. Registrul indicatorilor rămâne o resursă distinctă, iar validatorul formal nu emite aprecieri juridice.
v1.0 · compatible
Dosar Legea 52 și raportare anuală agregată
Dosarul public al consultării include termenele, recomandările motivate, evenimentele și versiunile finale. Noul export anual JSON/CSV sprijină raportarea din HG nr. 831/2022 fără a dubla dosarele E-consultare.
v1.0 · compatible
Contract procedural versionat pentru cererile 544
Metadatele declară regula juridică 5/10/15/30, iar setul agregat adaugă numărul reclamațiilor, soluționarea lor în termen și evenimentele procedurale întârziate. Câmpurile JSON și CSV sunt strict aditive și nu includ date personale.
v1.0 · compatible
Registru separat pentru definițiile indicatorilor
Adaugă /api/v1/indicator-definitions în JSON și CSV, cu proveniență, metodologie versionată și câmpuri operaționale marcate oficial, derivate sau de validat. /api/v1/indicators rămâne resursa măsurătorilor agregate demonstrative.
v1.0 · compatible
Serii longitudinale reproductibile în JSON și CSV
Dashboardul longitudinal este publicat ca set lună–indicator, cu schemă și metodologie versionate, snapshot determinist și tratarea explicită a valorilor lipsă.
v1.0 · operational
Protecție distribuită și SLO observabil
Limita 120/60s este contorizată atomic în PostgreSQL cu identitate pseudonimizată și fallback local; răspunsurile publică antete standard, identificatori de corelare și durata execuției la origine.
v1.0 · compatible
Paginare executată end-to-end în PostgreSQL
Instituțiile, publicările și consultările transferă numai pagina cerută, cu total exact și ordine stabilă, păstrând neschimbat contractul API.
v1.0 · compatible
Căutare coerentă și tolerantă la diacritice
Filtrul q folosește aceeași normalizare în interfață și API, iar instituțiile, publicările și consultările sunt filtrate în PostgreSQL prin indecși trigram.
v1.0 · governance
Contractul v1 este protejat automat
Baseline-ul public fixează rutele, parametrii, filtrele, sortarea și formatele stabile. CI oprește eliminările incompatibile și cere o versiune majoră nouă.
v1.0 · compatible
Cache condiționat și paginare navigabilă
Răspunsurile oferă ETag și 304, iar colecțiile publică legături standard first, prev, next și last fără a modifica forma datelor.