Locations v1 / Șomaj & construcții

Seria de șomaj a unui UAT

Evoluția lunară a șomajului înregistrat, din ianuarie 2010. Fiecare punct are și numărul,
și ponderea.

GET

https://oneapi.ro/api/locations/v1/uat/{cod}/somaj/serie

Parametri de cale

NumeTipDescriereExemplu

codobligatoriu string Codul SIRUTA al unităţii administrativ-teritoriale (ex. 54975 pentru Cluj-Napoca).

Parametri de interogare

NumeTipDescriereValori acceptate

sexopțional string | null Care serie. totalmasculinfeminin

de_laopțional integer | null Anul de început. 2010 – 2100

pana_laopțional integer | null Anul de sfârșit. 2010 – 2100

Cum se comportă

Seria lunară completă, din ianuarie 2010 — cel mult 198 de puncte. Fiecare punct are și numărul, și ponderea, deci nu trebuie cerută de două ori.
Fereastra e opțională și neplafonată: ruta e mereu pe o singură entitate, deci maximul absolut e istoria ei întreagă.
Fără sex se întoarce totalul.

La ce folosește

Grafic de evoluție a șomajului dintr-o localitate, pe 16 ani.
Detectarea unui șoc local (o fabrică închisă) care nu se vede în media județeană.
Comparație înainte/după între două perioade, fără să ceri fiecare lună separat.

Structura răspunsului

CâmpTipDescriere

data.entitate string Denumirea canonică a UAT-ului.

data.sex string Sexul pentru care e seria.

data.numitor string La ce se raportează pondere.

data.sursa string Sursa datelor.

data.serie[].an integer Anul punctului.

data.serie[].luna integer Luna punctului (1–12).

data.serie[].numar number | null Numărul de șomeri în acea lună.

data.serie[].pondere number | null Ponderea în resursele de muncă, în procente.

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

Exemple de răspuns

GEThttps://oneapi.ro/api/locations/v1/uat/54975/somaj/serie?de_la=2024

{
    "data": {
        "entitate": "Cluj-Napoca",
        "sex": "total",
        "numitor": "resurse de muncă",
        "sursa": "INS (şomaj înregistrat)",
        "serie": [
            {
                "an": 2024,
                "luna": 1,
                "numar": 635,
                "pondere": 0.3
            }
        ]
    },
    "meta": {
        "actualizat": {
            "somaj": "2026-09-14",
            "autorizatii": "2026-04-01"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/uat/54975/somaj/serie?sex=feminin&de_la=2025

{
    "data": {
        "entitate": "Cluj-Napoca",
        "sex": "feminin",
        "numitor": "resurse de muncă",
        "sursa": "INS (şomaj înregistrat)",
        "serie": [
            {
                "an": 2025,
                "luna": 1,
                "numar": 365,
                "pondere": 0.4
            }
        ]
    },
    "meta": {
        "actualizat": {
            "somaj": "2026-09-14",
            "autorizatii": "2026-04-01"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/uat/54975/somaj/serie

{
    "data": {
        "entitate": "Cluj-Napoca",
        "sex": "total",
        "numitor": "resurse de muncă",
        "sursa": "INS (şomaj înregistrat)",
        "serie": [
            {
                "an": 2010,
                "luna": 1,
                "numar": 6326,
                "pondere": 2.8
            }
        ]
    },
    "meta": {
        "actualizat": {
            "somaj": "2026-09-14",
            "autorizatii": "2026-04-01"
        }
    }
}

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	UAT-ul nu există.
422	validare	`sex` în afara listei sau fereastră inversată.
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": "sex în afara listei sau fereastră inversată.",
        "detalii": {
            "cod": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}