Limite și versiune
Se încarcă limitele curente din /api/v1/meta…
Valorile de mai sus sunt citite live de la server — această pagină nu poate rămâne în urmă față de API.
Endpointuri
| Metodă | Cale | Ce face |
|---|
Exemplu
curl -H "X-API-Key: lh_…" "https://legalhold.ro/api/v1/referinta?text=art.%201350%20alin.%20(2)%20C.civ."
Răspuns (prescurtat):
{
"api": "legalhold/v1.0",
"gasit": true,
"referinta": { "eticheta": "art. 1350 alin. (2) din Codul civil", "cheie": "cod civil|2009", "articol": "1350", "alineat": "2", "litera": null },
"act": { "titlu": "…", "id": 309285, "stem": "309285-cod-civil-a-04072016", "url": "https://legalhold.ro/legislatie/309285-cod-civil-a-04072016.html?…",
"forma": { "id": 309285, "data": "…", "tip": "R" }, "numarForme": 21, "formaCurenta": true },
"articol": { "numar": "1350", "text": "(1) Orice persoană trebuie să își execute obligațiile pe care le-a contractat. …", "trunchiat": false },
"atribuire": { "text": "Date furnizate de LegalHold (legalhold.ro), preluate din legislatie.just.ro. Textele nu au caracter oficial.", "obligatorie": true, "link": "https://legalhold.ro" }
}
Alte rezultate posibile: "motiv": "ambiguu" (mai multe acte cu aceeași referință — lista în candidati), "motiv": "act-negasit", "motiv": "nicio-referinta"; articol inexistent în forma curentă: "articol": {"gasit": false, …}.
Coduri de eroare
| HTTP | eroare | Ce înseamnă |
|---|---|---|
| 401 | cheie-lipsa, cheie-format, cheie-necunoscuta, cheie-revocata, cheie-expirata | Cheia lipsește sau nu mai e valabilă (valabilitate 12 luni; primești un email cu 14 zile înainte de expirare). |
| 403 | cheie-suspendata | Consum anormal — suspendare automată; scrie la contact@legalhold.ro. |
| 429 | limita-pe-minut, limita-zilnica | Limită atinsă; antetul Retry-After spune după câte secunde poți reîncerca. |
| 400 / 404 | parametru-lipsa, identificator-invalid, act-negasit, articol-negasit, ruta-necunoscuta | Cerere incompletă sau act/articol inexistent. |
| 5xx | eroare-interna, pagina-indisponibila | Eroare temporară — reîncearcă după câteva secunde (sunt monitorizate automat). |
Cheile tale API
Cheile sunt gratuite și se creează din contul LegalHold. Autentifică-te sau creează un cont.
| Cheie | Aplicație | Stare | Azi | 7 zile | Expiră |
|---|
Condiții de utilizare
- Atribuire. Oriunde afișezi date din API, arată textul din câmpul
atribuire.textși un link spreact.url(pagina actului pe legalhold.ro). - Fără caracter oficial. Textele sunt preluate de pe legislatie.just.ro; pentru forma oficială consultă Monitorul Oficial. LegalHold nu garantează actualitatea absolută a fiecărei forme.
- Limite. Cele afișate mai sus, per cheie; maximum 2 chei active per cont. Nu ocoli limitele (mai multe conturi, rotirea cheilor).
- Fără revânzare în bloc. API-ul e pentru integrări (afișarea unui articol citat, verificarea unei referințe), nu pentru copierea arhivei.
- Pilot. Versiunea 1 e un pilot: schema e stabilă pe durata v1 (câmpuri noi se pot adăuga, cele existente nu se schimbă fără o versiune nouă, anunțată pe email titularilor de chei).
- Suspendare. Consumul anormal duce la suspendarea automată a cheii; reactivarea se face la cerere.
Statistici păstrate: numărul de cereri pe cheie și zi (90 de zile), fără conținutul cererilor. Vezi și politica de confidențialitate. Extensia Chrome LegalHold folosește același API: extensie-chrome.html.