oneapi
Autentificare
Locations v1 / Șomaj & construcții

Categorii de autorizații

Nomenclatorul categoriilor, fiecare cu intervalul de ani în care e publicată — aici se vede
ruptura din 2009, când INS a despărțit alte_agregat în alte, comert și hoteluri.

GET
https://oneapi.ro/api/locations/v1/statistici/autorizatii/categorii

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

  • Nomenclator citit din date, nu dintr-o listă fixă în cod — dacă sursa adaugă o categorie, apare aici.
  • ⚠️ Ruptura din 2009. Până în 2008, INS publica un singur coș, alte_agregat; din 2009 l-a despărțit în alte, comert și hoteluri. Cele două perioade nu se suprapun niciodată, deci o serie continuă pe „altele" înseamnă alte_agregat până în 2008 și alte după.

La ce folosește

  • Popularea unui dropdown de categorii înainte de a cere o serie.
  • Aflarea intervalului real al unei categorii, ca să nu ceri ani în care nu se publica.
  • Explicarea într-un raport de ce o serie de comert începe abia în 2009.

Structura răspunsului

CâmpTipDescriere
data.categorii[].categorie string Cheia de folosit la parametrul categorie.
data.categorii[].primul_an integer Primul an în care sursa publică această categorie.
data.categorii[].ultimul_an integer Ultimul an publicat.
meta.actualizat object Prospețimea datelor pe domenii (dată ISO 8601).

Exemple de răspuns

GEThttps://oneapi.ro/api/locations/v1/statistici/autorizatii/categorii
{
    "data": {
        "categorii": [
            {
                "categorie": "administrative",
                "primul_an": 2002,
                "ultimul_an": 2025
            }
        ]
    },
    "meta": {
        "actualizat": {
            "somaj": "2026-09-14",
            "autorizatii": "2026-04-01"
        }
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
422validareRuta nu primeşte parametri, în afară de lang: orice alt parametru dă 422, nu e ignorat.
429cota_depasitaCota 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."
    }
}