Locations v1 / Șomaj & construcții

Seria de șomaj a unui județ

Evoluția lunară a șomajului înregistrat în județ, din ianuarie 2010.

GET

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

Parametri de cale

NumeTipDescriereExemplu

codobligatoriu string Codul judeţului, două litere (ex. CJ). Bucureştiul e B.

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ă a totalului județean, cel mult 198 de puncte, cu numărul și ponderea în același punct.
Fără sex se întoarce totalul.

La ce folosește

Grafic de evoluție a șomajului județean, din 2010.
Linie de referință peste care se suprapune seria unui UAT.
Analiză de sezonalitate pe date lunare.

Structura răspunsului

CâmpTipDescriere

data.entitate string Numele județ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/judete/CJ/somaj/serie?de_la=2024

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

GEThttps://oneapi.ro/api/locations/v1/judete/AB/somaj/serie

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

GEThttps://oneapi.ro/api/locations/v1/judete/CJ/somaj/serie

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

GEThttps://oneapi.ro/api/locations/v1/judete/B/somaj/serie

{
    "data": {
        "entitate": "București",
        "sex": "total",
        "numitor": "resurse de muncă",
        "sursa": "INS (şomaj înregistrat)",
        "serie": [
            {
                "an": 2010,
                "luna": 1,
                "numar": 26998,
                "pondere": 1.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	Județ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."
            ]
        }
    }
}