oneapi
Autentificare
Locations v1 / Ierarhie & dropdown-uri

Detaliu regiune

O regiune de dezvoltare după codul NUTS-2 (ex. RO11): populația cu defalcare, suprafața,
densitatea și câte județe, UAT-uri și localități conține. Cu ?include=judete vin și
județele, fiecare cu propriul cod NUTS-3.

GET
https://oneapi.ro/api/locations/v1/regiuni/{cod}

Parametri de cale

NumeTipDescriereExemplu
codobligatoriu string Codul NUTS 2 al regiunii de dezvoltare (ex. RO11).

Parametri de interogare

NumeTipDescriereValori acceptate
includelistăopțional text Secțiuni expandabile, separate prin virgulă. judete

Cum se comportă

  • Regiunile n-au cod SIRUTA — cheia publică e chiar codul NUTS-2 (RO11…RO42), de aceea apare și ca cod_nuts. Case-insensitive.
  • ?include=judete adaugă județele componente, fiecare cu propriul cod NUTS-3 — ierarhia NUTS completă într-un singur răspuns.
  • densitate e derivată (populație / suprafață) și e null când suprafața lipsește; nu se împarte la zero.
  • Populația e cea de la recensământul din populatie_detaliu.an, agregată din județe.

La ce folosește

  • Fișa unei regiuni de dezvoltare: populație, suprafață, densitate și câte unități conține.
  • Cap de raport regional, cu județele componente într-un singur apel.
  • Unirea cu seturi Eurostat pe codul NUTS-2.

Structura răspunsului

CâmpTipDescriere
data.cod string Codul regiunii (identic cu cod_nuts).
data.cod_nuts string Codul NUTS-2, pentru unire cu seturile Eurostat.
data.nume string Denumirea regiunii.
data.populatie integer | null Populația totală a regiunii.
data.populatie_detaliu.masculin integer | null Populația masculină.
data.populatie_detaliu.feminin integer | null Populația feminină.
data.populatie_detaliu.an integer | null Anul recensământului sursă.
data.populatie_detaliu.sursa string | null Sursa populației (ex. RPL2021).
data.suprafata_kmp number | null Suprafața regiunii, în km².
data.densitate number | null Locuitori pe km² (derivată).
data.nr_judete integer Câte județe conține.
data.nr_uat integer Câte UAT-uri conține.
data.nr_localitati integer Câte localități active conține.
data.judete[].cod string Indicativul auto al județului — chainable spre /judete/{cod}.
data.judete[].cod_nuts string | null Codul NUTS-3 al județului.
data.judete[].nume string Denumirea județului.
data.judete[].populatie integer | null Populația județului.
data.judete[].suprafata_kmp number | null Suprafața județului, în km².
meta.actualizat object Prospețimea datelor pe domenii (dată ISO 8601).

Exemple de răspuns

GEThttps://oneapi.ro/api/locations/v1/regiuni/RO11
{
    "data": {
        "cod": "RO11",
        "cod_nuts": "RO11",
        "nume": "Nord-Vest",
        "populatie": 2521793,
        "populatie_detaliu": {
            "masculin": 1226878,
            "feminin": 1294915,
            "an": 2021,
            "sursa": "RPL2021"
        },
        "suprafata_kmp": 34153.53,
        "densitate": 73.8,
        "nr_judete": 6,
        "nr_uat": 446,
        "nr_localitati": 1911
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "populatie": "2026-08-15T16: 40: 07+03: 00"
        }
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
404negasitRegiunea nu există.
422validareUn parametru nu a trecut validarea (include); detalii spune care şi de ce.
429cota_depasitaCota 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 nu a trecut validarea (include); detalii spune care şi de ce.",
        "detalii": {
            "cod": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}