Locations v1 / Ierarhie & dropdown-uri

Listă regiuni

Cele 8 regiuni de dezvoltare (NUTS-2), punctul de intrare al cascadei ierarhice
(regiune → județe → UAT → localități). Fiecare regiune include numărul de județe.

GET

https://oneapi.ro/api/locations/v1/regiuni

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Punctul de intrare al cascadei administrative. Setul e stabil — cache-uiește-l pe termen lung.
cod e codul NUTS-2 (RO11…), cheia pentru /regiuni/{cod}/judete.

La ce folosește

Primul nivel al unui selector de adresă în cascadă
Gruparea zonelor de acoperire pe macro-regiuni pentru dashboards și raportări
Segmentarea comercială pe regiuni de dezvoltare (NUTS-2)

Structura răspunsului

CâmpTipDescriere

data[].cod string Cod NUTS-2 (RO11, RO12…).

data[].nume string Denumirea entității.

data[].populatie integer | null Populația (recensământ).

data[].suprafata_kmp number | null Suprafața, în km².

data[].nr_judete integer Câte județe are regiunea.

meta.actualizat object Prospețimea datelor pe domenii (dată ISO 8601).

Exemple de răspuns

GEThttps://oneapi.ro/api/locations/v1/regiuni

{
    "data": [
        {
            "cod": "RO11",
            "nume": "Nord-Vest",
            "populatie": 2521793,
            "suprafata_kmp": 34153.53,
            "nr_judete": 6
        }
    ],
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "populatie": "2026-08-15T16: 40: 07+03: 00"
        }
    }
}

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