Locations v1 / Străzi

Codurile poștale ale unei străzi

Codurile poștale (nivel număr/bloc, MFP) ale străzii, grupate pe cod cu intervale de
numere și blocuri.

GET

https://oneapi.ro/api/locations/v1/strazi/{id}/coduri-postale

Parametri de cale

NumeTipDescriereExemplu

idobligatoriu string Identificatorul intern al străzii — se obţine din căutarea de străzi.

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Codurile poștale MFP ale străzii, grupate pe cod cu intervale de numere și blocuri.

La ce folosește

Atribuirea automată a codului poștal pornind de la numărul din adresă la checkout.
Validarea codului poștal introdus de client față de strada și numărul date.
Completarea codului poștal pe AWB-ul de curierat.

Structura răspunsului

CâmpTipDescriere

data[].cod_postal string Codul poștal.

data[].numere[] array Intervalele de numere acoperite de cod, cu paritate.

data[].numere[].start integer | null Primul număr din interval.

data[].numere[].sfarsit integer | null Ultimul număr din interval.

data[].numere[].paritate string | null Paritatea intervalului (numere pare / impare); null când e continuu.

data[].blocuri[] string Blocurile cărora li se aplică codul.

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

Exemple de răspuns

GEThttps://oneapi.ro/api/locations/v1/strazi/103906/coduri-postale

{
    "data": [
        {
            "cod_postal": "130003",
            "numere": [
                {
                    "start": 135,
                    "sfarsit": 177,
                    "paritate": "impar"
                }
            ],
            "blocuri": []
        }
    ],
    "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"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/strazi/216508/coduri-postale

{
    "data": [
        {
            "cod_postal": "012351",
            "numere": [
                {
                    "start": 1,
                    "sfarsit": 19,
                    "paritate": "impar"
                }
            ],
            "blocuri": []
        }
    ],
    "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"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/strazi/221714/coduri-postale

{
    "data": [
        {
            "cod_postal": "061931",
            "numere": [
                {
                    "start": 1,
                    "sfarsit": 3,
                    "paritate": "impar"
                }
            ],
            "blocuri": []
        }
    ],
    "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"
        }
    }
}

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	Strada 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": "Strada nu există."
    }
}