API v1
Datele sunt citite din contractul public versionat.
Contract public v1 · componente fără dependențe
Widgeturi portabile pentru publicări
Integrează o fișă sau lista unei instituții fără să copiezi datele. Widgetul citește API-ul public versionat, iar legătura semantică rămâne funcțională când JavaScript este dezactivat ori încărcarea externă este blocată.
Datele și instituțiile din exemple sunt fictive. Integrarea pe un site real rămâne în afara demonstratorului până la închiderea porților #31/#32/#152/#153.
Fără JavaScript
Fallbackul este o legătură semantică spre sursa canonică.
Izolare
Fără HTML injectat, credențiale sau cod dinamic evaluat.
Portabilitate
Export JSON complet, schemă deschisă și istoric păstrat.
Componenta 1
Fișa unei publicări
Sursa unică rămâne publicarea canonică. Scriptul cere numai slugul, verifică răspunsul API și construiește DOM cu text sigur.
Cod de integrare
<div data-transparenta-publication="date-contact-comuna-valea-digitala">
<a href="https://transparenta.digital/publicari/date-contact-comuna-valea-digitala">Deschide publicarea canonică</a>
</div>
<script async src="https://transparenta.digital/widgeturi/v1/publications.js" data-api-origin="https://transparenta.digital"></script>Componenta 2
Lista publicărilor unei instituții
Filtrul instituției este un identificator stabil, nu o copie a titlurilor sau documentelor. Orice corectare apare automat prin același API v1.
Cod de integrare
<div data-transparenta-publications data-institution="comuna-valea-digitala">
<a href="https://transparenta.digital/publicari?institution=comuna-valea-digitala">Vezi lista publicărilor canonice</a>
</div>
<script async src="https://transparenta.digital/widgeturi/v1/publications.js" data-api-origin="https://transparenta.digital"></script>Securitate și CSP
- permite originea scriptului în
script-src; - permite originea API în
connect-src; - permite foaia de stil versionată în
style-src; - nu transmite cookie-uri: cererile folosesc
credentials: omit; - păstrează fallbackul semantic în HTML-ul instituției.
Export, migrare și retragere
Pachetul JSON include înregistrarea curentă, istoricul publicării, istoricul payloadului structurat, checksumul și regulile de ciclu de viață. Schema este publică și nu depinde de Supabase, Vercel ori de un domeniu proprietar.
Specificația completă pentru cache, versionare, depreciere, self-hosting, rollback și comportamentul URL-urilor retrase este în documentația tehnică.