Business v1 / Nomenclatoare

Registre de autorizare

Cele 42 de registre din care se compun datele „name-only" (autoritate, licență, frecvență, nr intrări).

GET

https://oneapi.ro/api/business/v1/registre

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Lista registrelor de autorizare acoperite (ANSVSA, ANAF, ANRSC, ISCIR ş.a.), grupate. Intrările globale ale unui registru sunt la /registre/{key}.

La ce folosește

Aflarea ce registre de autorizare sunt acoperite, înainte de a integra.
Popularea unui selector de registru într-o interfaţă de verificare.
Punctul de plecare: cheia de aici se foloseşte la rutele de detaliu.

Structura răspunsului

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

CâmpTipDescriere

lista_key string Cheia registrului, de folosit în /registre/{key}.

denumire string Denumirea.

autoritate string Autoritatea care ţine registrul.

licenta string Licenţa sub care e publicat registrul.

url string Adresa sursei publice.

frecventa string Cât de des e reîmprospătat registrul.

are_cui boolean Registrul publică şi codul fiscal, deci firmele se pot lega exact.

nr_intrari integer Numărul de intrări.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/registre

{
    "data": [
        {
            "lista_key": "ansvsa",
            "denumire": "Unități autorizate/înregistrate sanitar-veterinar (DSVSA județene)",
            "autoritate": "ANSVSA",
            "licenta": "ANSVSA – date publice",
            "url": "https://www.ansvsa.ro/industrie-si-afaceri/",
            "frecventa": "periodic",
            "are_cui": true,
            "nr_intrari": 451712
        }
    ]
}

Coduri de eroare

Cod	Slug	Când apare
401	neautentificat	Token lipsă, invalid, expirat sau revocat.
403	feature_indisponibil	Planul curent nu include funcţia de care ţine ruta.
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."
    }
}