Business v1 / Persoane

Co-administratori

Co-administratorii unei persoane: persoanele care apar în aceleași firme, cu numărul de firme comune. Paginat.

GET

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

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ă

„Nu are” e un răspuns, nu o eroare. Când entitatea există, dar lista e goală, răspunsul e 200 cu listă goală. 404 înseamnă doar că entitatea din cale nu există.
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.
Persoanele care apar în aceleaşi firme cu persoana dată (co-administratori, co-asociaţi) — un self-join prin firme. Baza pentru grafuri de persoane.

La ce folosește

Construirea grafului de persoane pentru o analiză de reţea.
Detectarea grupurilor care apar împreună în mai multe firme.
Extinderea unei verificări de la o persoană la cercul ei de asociaţi.

Structura răspunsului

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

CâmpTipDescriere

total integer Totalul.

persoane[].id integer Identificatorul intern.

persoane[].nume string Numele.

persoane[].firme_comune integer Câte firme are în comun cu firma întrebată.

persoane[].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.

persoane[].judet_nastere null Judeţul naşterii, aşa cum îl publică registrul. Împreună cu identificator, deosebeşte omonimii la afişare.

Exemple de răspuns

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

{
    "data": {
        "total": 0,
        "persoane": []
    }
}

GEThttps://oneapi.ro/api/business/v1/persoane/85109718-b109-561c-b334-b1171d20ac7a/conexe

{
    "data": {
        "total": 4062,
        "persoane": [
            {
                "id": 14639039,
                "identificator": "a476c810-7322-5e70-a2e0-4c73964f48e6",
                "nume": "CATALINOIU OVIDIU",
                "judet_nastere": null,
                "firme_comune": 5
            }
        ]
    }
}

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

{
    "data": {
        "total": 4149,
        "persoane": [
            {
                "id": 14639039,
                "identificator": "a476c810-7322-5e70-a2e0-4c73964f48e6",
                "nume": "CATALINOIU OVIDIU",
                "judet_nastere": null,
                "firme_comune": 5
            }
        ]
    }
}

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."
            ]
        }
    }
}