Identificatori v1 / Identificatori

Tipuri recunoscute

Catalogul identificatorilor pe care îi validăm — CUI, CNP, IBAN, LEI, EORI, cod de TVA şi restul — fiecare cu eticheta, forma aşteptată şi dacă validarea îi verifică cifra de control.

GET

https://oneapi.ro/api/identificatori/v1/tipuri

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Ordinea din listă e ordinea de SPECIFICITATE, folosită la detecția automată: tipurile cu structură rigidă (VIN, LEI, ISIN) sunt încercate înaintea celor permisive (CUI). Nu e o ordine alfabetică sau de importanță.
Validarea e MATEMATICĂ. Confirmă că un identificator e bine format — nu că entitatea din spatele lui există. Un IBAN corect poate fi al unui cont închis, iar un BIC bine format poate fi al unei bănci care nu există.
Singurul tip marcat date_personale e CNP-ul, iar el are reguli separate: doar POST, fără cache, fără retenție, exclus din loturi și din detecția automată.

La ce folosește

Afli ce poți valida și după ce standard, înainte de a scrie prima integrare.
Populezi un selector de tip într-o interfață de curățare a datelor.
Verifici care tipuri sunt tratate ca date personale, ca să știi ce reguli se aplică.

Structura răspunsului

Toate câmpurile de mai jos sunt în data.

CâmpTipDescriere

inregistrari integer Câte înregistrări are răspunsul.

tipuri[].cod string Codul folosit în rute și în parametrul tip.

tipuri[].eticheta string Denumirea lizibilă.

tipuri[].standard string Standardul sau actul normativ din care vine regula.

tipuri[].rezumat string Ce se verifică efectiv și ce nu.

tipuri[].date_personale boolean true doar la CNP, care are reguli de acces separate.

observatie string Precizare despre cum se citeşte răspunsul: o convenţie de calcul sau o limită a datelor.

Exemple de răspuns

GEThttps://oneapi.ro/api/identificatori/v1/tipuri

{
    "data": {
        "inregistrari": 10,
        "tipuri": [
            {
                "cod": "vin",
                "eticheta": "VIN — serie de caroserie",
                "standard": "ISO 3779 / ISO 3780",
                "rezumat": "17 caractere, fără I, O și Q. Decodare parțială: structură, cifră de control, an-model, regiune.",
                "date_personale": false
            }
        ],
        "observatie": "Validarea e MATEMATICĂ: confirmă că un identificator e bine format, nu că entitatea din spatele lui există. Singura rută care întreabă o sursă externă e `/vies/*`."
    }
}

Coduri de eroare

Cod	Slug	Când apare
401	neautentificat	Token lipsă, invalid, expirat sau revocat.
403	modul_interzis	Tokenul nu are acces la modulul rutei.
422	validare	Ruta nu primeşte parametri, în afară de `lang`: orice alt parametru dă 422, nu e ignorat.
429	cota_depasita	Cota lunară a planului a fost depăşită (vezi `Retry-After`).

Toate erorile au aceeași formă. eroare.cod e stabil și e cel după care trebuie să ramifici în cod — nu după textul din mesaj, care se poate schimba.

{
    "eroare": {
        "cod": "validare",
        "mesaj": "Ruta nu primeşte parametri, în afară de lang: orice alt parametru dă 422, nu e ignorat."
    }
}