Business v1 / Persoane

Profil persoană

Datele unei persoane (nume, localitate) + numărul de firme în care apare.

GET

https://oneapi.ro/api/business/v1/persoane/{id}

Parametri de cale

NumeTipDescriereExemplu

idobligatoriu string Identificatorul intern al persoanei — se obţine din răspunsurile de căutare, nu e un CNP.

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Numele singur nu identifică pe nimeni, iar registrul nu publică CNP-ul. De aceea fiecare persoană vine cu identificator (UUID derivat din nume + judeţul naşterii + ziua naşterii) şi cu judet_nastere. Data naşterii nu se stochează şi nu se expune — intră doar în identificator. Unde registrul nu dă data naşterii (13% din menţiuni, mai ales lichidatori persoane juridice), persoana rămâne distinctă la fiecare firmă, ca să nu inventăm legături.
Profilul unei persoane (identificator intern), cu numărul de firme în care apare. Firmele efective sunt la /persoane/{id}/firme.

La ce folosește

Fişa unei persoane într-o aplicaţie de analiză, cu amploarea implicării ei.
Trierea rezultatelor unei căutări după câte firme are fiecare persoană.
Un antet stabil de la care lanţui spre firme, roluri şi conexiuni.

Structura răspunsului

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

CâmpTipDescriere

id integer Identificatorul intern.

identificator string Identificatorul stabil al persoanei (UUID), derivat din nume + judeţul naşterii + ziua naşterii. Spre deosebire de id, nu se schimbă la reimport. Foloseşte-l ca să ştii dacă administratorul a două firme e acelaşi om ori doi omonimi.opțional

nume string Numele.

judet_nastere string Judeţul naşterii, aşa cum îl publică registrul. Împreună cu identificator, deosebeşte omonimii la afişare.opțional

localitate string Localitatea.opțional

judet string Judeţul.opțional

tara string Ţara.opțional

nr_firme integer Numărul de firme.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/persoane/abecb6a3-ce1d-5648-b7c3-1ab11a3a6046

{
    "data": {
        "id": 16383590,
        "identificator": "abecb6a3-ce1d-5648-b7c3-1ab11a3a6046",
        "nume": "POPESCU A. ALEXANDRA",
        "judet_nastere": "Bucureşti",
        "nr_firme": 0
    }
}

GEThttps://oneapi.ro/api/business/v1/persoane/ca5d0b82-e0a9-5b30-b28b-b2a7971f7e4a

{
    "data": {
        "id": 16383591,
        "identificator": "ca5d0b82-e0a9-5b30-b28b-b2a7971f7e4a",
        "nume": "POPESCU A.ALEXANDRU",
        "nr_firme": 1
    }
}

GEThttps://oneapi.ro/api/business/v1/persoane/1a316a50-157a-5cc5-a545-86f333631344

{
    "data": {
        "id": 14400593,
        "identificator": "1a316a50-157a-5cc5-a545-86f333631344",
        "nume": "BERNEANU NICOLETA - SOFIA",
        "judet_nastere": "Bucureşti",
        "nr_firme": 1878
    }
}

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.
404	negasit	Persoana [{id}] nu a fost găsită.
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.",
        "detalii": {
            "id": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}