Locations v1 / Căutare & rezolvare

Entitate după identificator extern

⭐ Traduce un identificator din alt set de date în entitatea noastră: wikidata (QID),
geonames (id numeric) sau nuts (cod NUTS-2 sau NUTS-3). Sensul invers — identificatorii
externi ai unei entități — e în răspunsul rutelor de detaliu.

GET

https://oneapi.ro/api/locations/v1/referinte/{sursa}/{id}

Parametri de cale

NumeTipDescriereExemplu

sursaobligatoriu string Sursa identificatorului extern (wikidata, geonames, osm).

idobligatoriu string Identificatorul din sursa externă aleasă (ex. Q182624 la Wikidata).

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

⭐ Puntea în sens invers: identificatorii externi ai unei entități apar în răspunsul rutelor de detaliu, iar aici se pornește de la ei înapoi spre entitate.
Surse acceptate: wikidata (QID, ex. Q182624), geonames (id numeric) și nuts (cod NUTS-2 sau NUTS-3).
Răspunsul e o listă, nu un singur obiect, fiindcă același identificator extern poate descrie mai multe niveluri de-ale noastre: GeoNames are o singură intrare pentru „Cluj-Napoca" (681290), care la noi e și UAT, și localitate. Nu e un duplicat, sunt două entități distincte.
NUTS acoperă două niveluri: NUTS-2 sunt regiunile de dezvoltare (codul lor chiar e codul NUTS), NUTS-3 sunt județele. Sub județ nu există NUTS.
Potrivirea e case-insensitive (q182624 = Q182624).

La ce folosește

Ai un set de date cheiat pe Wikidata sau GeoNames și vrei să-l unești cu al nostru fără potrivire pe nume.
Traduci un cod NUTS dintr-un tabel Eurostat în județul sau regiunea corespunzătoare.
Verifici că un identificator extern chiar corespunde entității pe care o crezi.

Structura răspunsului

CâmpTipDescriere

data[].nivel string Nivelul entității găsite: regiune, judet, uat sau localitate.

data[].cod string Cheia publică a acelui nivel — cod auto la județ, cod NUTS la regiune, cod SIRUTA la UAT și localitate.

data[].nume string Denumirea canonică.

data[].tip string | null Tipul entității, unde există (comuna/oras/sat…).

data[].parinte.nivel string Nivelul entității superioare.

data[].parinte.cod string Cheia publică a entității superioare.

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

data[].parinte.judet string Codul auto al județului — prezent doar când entitatea găsită e o localitate.opțional

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

Exemple de răspuns

GEThttps://oneapi.ro/api/locations/v1/referinte/wikidata/Q182624

{
    "data": [
        {
            "nivel": "judet",
            "cod": "CJ",
            "nume": "Cluj",
            "tip": null,
            "parinte": null
        }
    ],
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "referinte_externe": "2026-09-04T21: 24: 20+03: 00"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/referinte/geonames/681290

{
    "data": [
        {
            "nivel": "uat",
            "cod": "54975",
            "nume": "Cluj-Napoca",
            "tip": "municipiu",
            "parinte": {
                "nivel": "judet",
                "cod": "CJ",
                "nume": "Cluj"
            }
        }
    ],
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "referinte_externe": "2026-09-04T21: 24: 20+03: 00"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/referinte/nuts/RO113

{
    "data": [
        {
            "nivel": "judet",
            "cod": "CJ",
            "nume": "Cluj",
            "tip": null,
            "parinte": {
                "nivel": "regiune",
                "cod": "RO11",
                "nume": "Nord-Vest"
            }
        }
    ],
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "referinte_externe": "2026-09-04T21: 24: 20+03: 00"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/referinte/nuts/RO11

{
    "data": [
        {
            "nivel": "regiune",
            "cod": "RO11",
            "nume": "Nord-Vest",
            "tip": null,
            "parinte": null
        }
    ],
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "referinte_externe": "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	Sursă necunoscută (răspunsul dă lista acceptată) sau niciun rezultat pentru identificator.
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": "Sursă necunoscută (răspunsul dă lista acceptată) sau niciun rezultat pentru identificator."
    }
}