Business v1 / Persoane

Căutare persoane

Caută persoane după nume (fuzzy). Fiecare rezultat cu numărul de firme în care apare. Paginat.

GET

https://oneapi.ro/api/business/v1/persoane/cauta

Parametri de interogare

NumeTipDescriereValori acceptate

qopțional string | null Numele căutat (potrivire fuzzy). ex. popescuex. ionescuex. georgescu

Cum se comportă

Caută persoane (administratori/asociaţi) după nume, cu potrivire fuzzy, şi întoarce numărul de firme al fiecăreia. Căutarea foloseşte un index trigram (rapid).
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.

La ce folosește

Găsirea unei persoane când ai numele dintr-un document, nu un identificator.
Ecranarea unui semnatar înainte de a intra într-o relaţie comercială.
Punctul de intrare în analiza de reţea: de la nume la firmele legate.

Structura răspunsului

CâmpTipDescriere

data[].id integer Identificatorul intern.

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

data[].nume string Numele.

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

data[].localitate string Localitatea.opțional

data[].judet string Judeţul.opțional

data[].tara string Ţara.opțional

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

meta.paginare.pagina integer Pagina curentă.

meta.paginare.per_pagina integer Rezultate pe pagină.

meta.paginare.total integer Total rezultate.

meta.paginare.pagini integer Număr de pagini.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/persoane/cauta?q=popescu

{
    "data": [
        {
            "id": 16383590,
            "identificator": "abecb6a3-ce1d-5648-b7c3-1ab11a3a6046",
            "nume": "POPESCU A. ALEXANDRA",
            "judet_nastere": "Bucureşti",
            "nr_firme": 0
        }
    ],
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 18611,
            "pagini": 931
        }
    }
}

GEThttps://oneapi.ro/api/business/v1/persoane/cauta?q=ionescu

{
    "data": [
        {
            "id": 15576844,
            "identificator": "db91b969-bfeb-5f3b-8a85-37c18b99f05a",
            "nume": "IONESCU",
            "nr_firme": 8
        }
    ],
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 12415,
            "pagini": 621
        }
    }
}

GEThttps://oneapi.ro/api/business/v1/persoane/cauta?q=georgescu

{
    "data": [
        {
            "id": 15343065,
            "identificator": "fdaf335a-e58a-5322-9829-0ceb3b3a1e26",
            "nume": "GEORGESCU A. CORINA",
            "nr_firme": 1
        }
    ],
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 5173,
            "pagini": 259
        }
    }
}

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	Un parametru nedeclarat ori o valoare care nu trece validarea (`q`). Câmpul vinovat e în `detalii`.
422	q_scurt	Numele căutat trebuie să aibă cel puțin 3 caractere.
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": "Un parametru nedeclarat ori o valoare care nu trece validarea (q). Câmpul vinovat e în detalii.",
        "detalii": {
            "q": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}