Locations v1 / Proximitate & zone

Vecinii unui județ

Județele adiacente unui județ, ordonate după lungimea graniței comune. Identificat prin
cod_auto.

GET

https://oneapi.ro/api/locations/v1/judete/{cod}/vecini

Parametri de cale

NumeTipDescriereExemplu

codobligatoriu string Codul judeţului, două litere (ex. CJ). Bucureştiul e B.

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Județul e identificat prin indicativul auto (cod, ex. CJ), nu prin cod SIRUTA.
Vecinătatea = graniță comună pe limitele oficiale ANCPI; lista e ordonată descrescător după lungime_granita_m.

La ce folosește

Extinderea acoperirii unui serviciu la județele limitrofe.
Rutarea agenților/reprezentanților pe grupuri de județe adiacente.
Agregarea campaniilor sau stocurilor pe județe învecinate.

Structura răspunsului

CâmpTipDescriere

data[].cod string Indicativul auto al județului vecin (ex. AB, SJ, MS).

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

data[].lungime_granita_m integer Lungimea graniței comune cu județul interogat, în metri (criteriul de sortare).

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

Exemple de răspuns

GEThttps://oneapi.ro/api/locations/v1/judete/CJ/vecini

{
    "data": [
        {
            "cod": "SJ",
            "nume": "Sălaj",
            "lungime_granita_m": 238204
        }
    ],
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": "2026-09-04T21: 24: 20+03: 00"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/judete/AB/vecini

{
    "data": [
        {
            "cod": "SB",
            "nume": "Sibiu",
            "lungime_granita_m": 199438
        }
    ],
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": "2026-09-04T21: 24: 20+03: 00"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/judete/B/vecini

{
    "data": [
        {
            "cod": "IF",
            "nume": "Ilfov",
            "lungime_granita_m": 103538
        }
    ],
    "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	Județul nu există.
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": "negasit",
        "mesaj": "Județul nu există."
    }
}