Locations v1 / Străzi

Străzile unei localități

Lista paginată a străzilor unei localități (cod_siruta), cu căutare pe prefix (q) și
dedup al variantelor fantomă (același nume). are_geo marchează străzile cu geometrie.

GET

https://oneapi.ro/api/locations/v1/localitati/{cod}/strazi

Parametri de cale

NumeTipDescriereExemplu

codobligatoriu string Codul SIRUTA al localităţii (ex. 54984).

Parametri de interogare

NumeTipDescriereValori acceptate

qopțional string | null Prefix de căutare în străzile localității. min 1 caracter

Cum se comportă

Căutarea națională de străzi nu e permisă — dă mereu contextul localității.
Variantele fantomă (același nume, duplicate MFP) sunt deduplicate la afișare; câștigă cea cu geometrie.
are_geo = are linie OSM, deci detaliul geo (lungime, intersecții, capete) e disponibil.

La ce folosește

Autocomplete de stradă în formularul de adresă, după ce clientul a ales localitatea.
Popularea unui dropdown de străzi la checkout, filtrat pe localitatea din coș.
Verificarea că o stradă tastată manual aparține efectiv localității declarate.

Structura răspunsului

CâmpTipDescriere

data[].id integer Identificatorul (intern) al străzii — cheia pentru /strazi/{id}.

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

data[].tip string Cod tip arteră (denumiri în /nomenclatoare/tipuri).

data[].cod_postal string | null Codul poștal al străzii, unde e unic pe toată artera.

data[].are_geo boolean Strada are geometrie (linie OSM) atașată — de asta depind rutele de segment și intersecții.

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.

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

Exemple de răspuns

GEThttps://oneapi.ro/api/locations/v1/localitati/54984/strazi

{
    "data": [
        {
            "id": 14612,
            "nume": "11 Octombrie",
            "tip": "strada",
            "cod_postal": "400211",
            "are_geo": true
        }
    ],
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "strazi": "2026-10-04T19: 50: 09+03: 00",
            "geo": "2026-10-06T16: 33: 40+03: 00"
        },
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 1217,
            "pagini": 61
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/localitati/54984/strazi?q=memorandumului

{
    "data": [
        {
            "id": 14540,
            "nume": "Memorandumului",
            "tip": "strada",
            "cod_postal": "400114",
            "are_geo": true
        }
    ],
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "strazi": "2026-10-04T19: 50: 09+03: 00",
            "geo": "2026-10-06T16: 33: 40+03: 00"
        },
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 1,
            "pagini": 1
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/localitati/179196/strazi?q=acvariului

{
    "data": [
        {
            "id": 221472,
            "nume": "Acvariului",
            "tip": "strada",
            "cod_postal": "061493",
            "are_geo": true
        }
    ],
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "strazi": "2026-10-04T19: 50: 09+03: 00",
            "geo": "2026-10-06T16: 33: 40+03: 00"
        },
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 1,
            "pagini": 1
        }
    }
}

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	Localitatea nu există.
422	validare	Un parametru nu a trecut validarea (`q`); `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 (q); detalii spune care şi de ce.",
        "detalii": {
            "cod": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}