Business v1 / Meta

Surse de date

Sursele din spatele datelor: registrele „name-only" (cele 42) + sursele core (ONRC/ANAF/MF/SEAP).

GET

https://oneapi.ro/api/business/v1/meta/surse

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Sursele oficiale din care vine fiecare felie de date (ONRC, ANAF, MF, SEAP, INS ş.a.), inclusiv registrele de autorizare — proveniența declarată a modulului.

La ce folosește

Citarea corectă a sursei într-un raport sau într-un articol.
Documentarea provenienţei datelor într-un dosar de conformitate.
Verificarea faptului că sursele acoperă nevoia ta, înainte de a integra.

Structura răspunsului

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

CâmpTipDescriere

core[].sursa string Sursa de bază (ONRC, ANAF, Ministerul Finanţelor…).

core[].descriere string Ce aduce sursa în modul.

registre[].lista_key string Cheia registrului, de folosit în /firme/{cui}/registre/{registru}.

registre[].denumire string Denumirea registrului.

registre[].autoritate string Autoritatea care îl publică.

registre[].licenta string Sub ce licenţă e publicat.

registre[].url string|null Adresa sursei oficiale.

registre[].frecventa string Cât de des se actualizează la sursă.

registre[].are_cui boolean Dacă sursa publică CUI-ul (altfel intrările se leagă prin potrivire de nume).

registre[].nr_intrari integer Câte intrări are registrul.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/meta/surse

{
    "data": {
        "core": [
            {
                "sursa": "ONRC",
                "descriere": "Registrul Comerțului — identitate, sediu, persoane, activități"
            }
        ],
        "registre": [
            {
                "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."
    }
}