Date deschise

Tot ce e pe Clarity vine din surse oficiale și se poate lua mai departe: printr-un API public, fără cheie de acces și fără cont, sau ca widget de pus într-un articol. Dacă scrii despre un vot, ia cifrele de aici — și pune linkul la sursa oficială, pe care îl găsești în fiecare răspuns.

API-ul, pe scurt

Doar citire, doar GET, JSON, fără autentificare. Se poate chema din orice pagină (CORS deschis). Limită: 60 de cereri pe minut de la aceeași adresă.

curl https://clarityvede.ro/api/public/v1/legi?q=pensii&limit=5

Punctul de pornire, care se descrie singur: /api/public/v1 · versiunea 1.0

Ce poți cere

`GET /api/public/v1/legi`	lista legilor, cu filtre
`GET /api/public/v1/legi/{slug}`	o lege, cu voturile ei
`GET /api/public/v1/voturi/{id}`	o sesiune de vot, cu lista nominală
`GET /api/public/v1/politicieni`	lista parlamentarilor
`GET /api/public/v1/politicieni/{slug}`	un parlamentar, cu mandatele
`GET /api/public/v1/consultari`	proiectele aflate în consultare publică

Citește asta înainte să publici o cifră

Datele parlamentare au capcane care inversează sensul unei știri. Le trimitem în fiecare răspuns, ca să nu depindă de citirea documentației:

`vot_pe_respingere: true` înseamnă că s-a votat pe RESPINGEREA legii: acolo „pentru” e pentru respingere, iar cifrele citite naiv spun exact pe dos ce s-a întâmplat.
`rezultat_oficial` vine din rezoluția sursei, nu din aritmetica noastră, și poate lipsi chiar și la voturi finale.
Grupul parlamentar dintr-un vot nominal e cel de LA DATA VOTULUI, nu cel de azi.
Rezumatele sunt generate automat și marcate ca atare. Nu sunt text de lege.
Actele administrative (numiri, inventare) sunt marcate cu `administrativ: true`, nu ascunse.

Widget pentru un vot

Fiecare pagină de vot are butonul „citează sau încorporează”, cu codul gata de copiat. Widget-ul arată rezultatul oficial, cifrele și duce la lista nominală. Se actualizează singur dacă sursa își corectează cifrele.

<iframe src="https://clarityvede.ro/embed/vot/3016" width="100%"
  height="270" style="border:0" loading="lazy"></iframe>

Ce promitem și ce nu

Promitem: cât timp există v1, câmpurile existente nu se șterg și nu își schimbă înțelesul. Putem adăuga câmpuri noi — un cititor de JSON ignoră ce nu cunoaște. Ce nu se poate face aditiv intră în v2, iar v1 rămâne în aer.

Nu promitem: că datele sunt complete sau fără greșeli. Vin automat din surse care se schimbă și uneori cad; starea fiecăreia e la Starea surselor. Sursa oficială prevalează întotdeauna. Dacă găsești o eroare, scrie-ne — se corectează în aceeași zi.

Licență: Datele sunt informații publice. Se pot folosi liber, inclusiv comercial, cu sursa la vedere: „Clarity (clarityvede.ro)”. Fără garanții — sursa oficială prevalează întotdeauna.

Ai nevoie de ceva ce nu găsești aici — o extragere anume, un format, un endpoint nou? Scrie la contact@clarityvede.ro. Răspundem.