Locations v1 / Proximitate & zone

Zonă de livrare

⭐ O zonă gata de folosit: un UAT (uat=cod_siruta) plus vecinii lui (cu
include_vecini=1) + un rezumat de acoperire (număr UAT + populație totală).

GET

https://oneapi.ro/api/locations/v1/zona-livrare

Parametri de interogare

NumeTipDescriereValori acceptate

uatobligatoriu integer cod_siruta al UAT-ului central. ex. 54975ex. 179132

include_veciniopțional boolean | null Include UAT-urile vecine. 01

Cum se comportă

Zonă gata de folosit: un UAT plus vecinii lui (cu include_vecini=1) + rezumat de acoperire.

La ce folosește

Definirea într-un singur apel a zonei de livrare a unui magazin (UAT central + vecini).
Afișarea unui rezumat de acoperire în dashboard (număr de UAT-uri și populație totală).
Estimarea pieței la onboarding-ul unui partener nou pe baza UAT-ului sediului.

Structura răspunsului

CâmpTipDescriere

data.centru.cod_siruta integer Codul SIRUTA (cheia publică a entității).

data.centru.nume string Denumirea entității.

data.centru.tip string Tipul entității (cod brut; denumirile la /nomenclatoare/tipuri).

data.centru.judet.cod string Indicativul auto al județului.

data.centru.judet.nume string Numele județului.

data.centru.populatie integer Populația (recensământ).

data.zona[].cod_siruta integer Codul SIRUTA (cheia publică a entității).

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

data.zona[].tip string Tipul entității (cod brut; denumirile la /nomenclatoare/tipuri).

data.zona[].judet.cod string Indicativul auto al județului.

data.zona[].judet.nume string Numele județului.

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

data.rezumat.nr_uat integer Câte UAT-uri intră în zonă (centrul + vecinii).

data.rezumat.populatie_totala integer Suma populației UAT-urilor din zonă.

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

Exemple de răspuns

GEThttps://oneapi.ro/api/locations/v1/zona-livrare?uat=54975

{
    "data": {
        "centru": {
            "cod_siruta": 54975,
            "nume": "Cluj-Napoca",
            "tip": "municipiu",
            "judet": {
                "cod": "CJ",
                "nume": "Cluj"
            },
            "populatie": 286598
        },
        "zona": [
            {
                "cod_siruta": 54975,
                "nume": "Cluj-Napoca",
                "tip": "municipiu",
                "judet": {
                    "cod": "CJ",
                    "nume": "Cluj"
                },
                "populatie": 286598
            }
        ],
        "rezumat": {
            "nr_uat": 1,
            "populatie_totala": 286598
        }
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": "2026-09-04T21: 24: 20+03: 00"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/zona-livrare?uat=54975&include_vecini=1

{
    "data": {
        "centru": {
            "cod_siruta": 54975,
            "nume": "Cluj-Napoca",
            "tip": "municipiu",
            "judet": {
                "cod": "CJ",
                "nume": "Cluj"
            },
            "populatie": 286598
        },
        "zona": [
            {
                "cod_siruta": 54975,
                "nume": "Cluj-Napoca",
                "tip": "municipiu",
                "judet": {
                    "cod": "CJ",
                    "nume": "Cluj"
                },
                "populatie": 286598
            }
        ],
        "rezumat": {
            "nr_uat": 8,
            "populatie_totala": 384987
        }
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": "2026-09-04T21: 24: 20+03: 00"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/zona-livrare?uat=179132

{
    "data": {
        "centru": {
            "cod_siruta": 179132,
            "nume": "București",
            "tip": "municipiu",
            "judet": {
                "cod": "B",
                "nume": "București"
            },
            "populatie": 1716961
        },
        "zona": [
            {
                "cod_siruta": 179132,
                "nume": "București",
                "tip": "municipiu",
                "judet": {
                    "cod": "B",
                    "nume": "București"
                },
                "populatie": 1716961
            }
        ],
        "rezumat": {
            "nr_uat": 1,
            "populatie_totala": 1716961
        }
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": "2026-09-04T21: 24: 20+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.
404	negasit	UAT-ul central nu există.
422	validare	Un parametru nu a trecut validarea (`uat`, `include_vecini`); `detalii` spune care şi de ce.
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 nu a trecut validarea (uat, include_vecini); detalii spune care şi de ce.",
        "detalii": {
            "uat": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}