Locations v1 / Referință & business

Versiune

Versiunea API + ediția datelor (cea mai recentă importare).

GET

https://oneapi.ro/api/locations/v1/versiune

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Versiunea API + ediția datelor (cea mai recentă importare). Nu necesită un feature anume.

La ce folosește

Afișarea versiunii API + ediției datelor într-un footer sau pagină „about”.
Telemetrie: loghezi ce ediție de date a stat la baza unui răspuns.
Detectarea unei ediții noi de date pentru a invalida cache-uri client.

Structura răspunsului

Toate câmpurile de mai jos sunt în data.

CâmpTipDescriere

api string Versiunea API-ului.

modul string Versiunea modulului Locations.

editie_date string | null Eticheta celei mai recente importări (ediția datelor); null dacă necunoscută.

Exemple de răspuns

GEThttps://oneapi.ro/api/locations/v1/versiune

{
    "data": {
        "api": "v1",
        "modul": "locations",
        "editie_date": "2026-10-06T16: 33: 40+03: 00"
    }
}

Coduri de eroare

Cod	Slug	Când apare
401	neautentificat	Token lipsă, invalid, expirat sau revocat.
403	modul_interzis	Tokenul nu are acces la modulul rutei.
422	validare	Ruta nu primeşte parametri, în afară de `lang`: orice alt parametru dă 422, nu e ignorat.
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": "Ruta nu primeşte parametri, în afară de lang: orice alt parametru dă 422, nu e ignorat."
    }
}