Locations v1 / Referință & business

Meta / starea datelor

Prospețimea datelor pe domenii + acoperirea (numărători: județe, UAT, localități, străzi
cu geometrie, adrese).

GET

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

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Prospețimea datelor pe domenii + acoperirea (numărători). Bun pentru un status/health al datelor.

La ce folosește

Health-check al datelor într-un monitor: confirmi că importurile sunt recente.
Afișarea unui „date actualizate la…” în UI, pentru încredere.
Cache-busting: reîmprospătezi cache-ul local când acoperirea sau prospețimea se schimbă.

Structura răspunsului

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

CâmpTipDescriere

actualizat.administrativ string | null Când a fost preluat ultima oară nomenclatorul SIRUTA.

actualizat.geo string | null Când au fost preluate ultima oară limitele administrative.

actualizat.populatie string | null Când a fost preluat ultima oară recensământul.

actualizat.strazi string | null Când au fost preluate ultima oară străzile.

actualizat.adrese string | null Când au fost preluate ultima oară punctele de adresă.

acoperire.judete integer Câte județe are nomenclatorul.

acoperire.uat integer Câte UAT-uri are nomenclatorul.

acoperire.localitati integer Câte localități active are nomenclatorul.

acoperire.strazi_cu_geometrie integer Câte străzi au linie OSM (acoperire parțială, nu toate).

acoperire.adrese integer Numărul de adrese (numere) cunoscute în date.

Exemple de răspuns

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

{
    "data": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": "2026-09-04T21: 24: 20+03: 00",
            "populatie": "2026-08-15T16: 40: 07+03: 00",
            "strazi": "2026-10-04T19: 50: 09+03: 00",
            "adrese": "2026-10-06T16: 33: 40+03: 00"
        },
        "acoperire": {
            "judete": 42,
            "uat": 3181,
            "localitati": 13755,
            "strazi_cu_geometrie": 94290,
            "adrese": 1044346
        }
    }
}

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.
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."
    }
}