Business v1 / Persoane

Rolurile unei persoane

Defalcarea mandatelor unei persoane pe tipuri de rol — administrator, asociat, cenzor, lichidator — cu numărul de firme pentru fiecare.

GET

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

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ă.
Rolurile pe care persoana le deţine în firme (administrator, asociat, lichidator etc.), agregate pe tip.

La ce folosește

Distingerea unui administrator activ de un simplu asociat, într-un scoring.
Filtrarea unei liste de persoane după tipul de implicare.
Un rezumat compact al rolurilor, fără să paginezi lista de firme.

Structura răspunsului

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

CâmpTipDescriere

roluri[].rol string Rolul deţinut (administrator, asociat…).

roluri[].nr_firme integer Numărul de firme.

Exemple de răspuns

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

{
    "data": {
        "roluri": []
    }
}

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

{
    "data": {
        "roluri": [
            {
                "rol": "reprezentant al persoanei juridice",
                "nr_firme": 1865
            }
        ]
    }
}

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

{
    "data": {
        "roluri": [
            {
                "rol": "reprezentant al persoanei juridice",
                "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."
            ]
        }
    }
}