Financiar v1 / Serii

Clasele statistice BNR

Clasele din care provin seriile, cu numărul de serii, numărul total de valori şi acoperirea
fiecăreia. Utile ca punct de plecare: se alege o clasă, apoi se filtrează catalogul pe ea.

GET

https://oneapi.ro/api/financiar/v1/clase

Parametri de interogare

NumeTipDescriereValori acceptate

cautaopțional string | null Text în denumirea clasei, minim 2 caractere. Fără diacritice. ex. Clujex. credit

Cum se comportă

Clasele din care provin seriile, cu numărul de serii, numărul total de valori şi acoperirea temporală a fiecăreia.
E punctul firesc de plecare: se alege o clasă, apoi se filtrează catalogul pe ea cu /serii?clasa=.
Căutarea ignoră diacriticele: ?cauta=dobanzi găseşte „Ratele dobânzilor BNR".
Numerele acoperă doar seriile temporale; registrele nu sunt incluse, la fel ca în catalog.

La ce folosește

Navigarea catalogului BNR pe clase, într-un selector.
Estimarea, înainte de a integra, cât de mult acoperă fiecare clasă.
Punctul de plecare pentru a găsi codul seriei care îţi trebuie.

Structura răspunsului

CâmpTipDescriere

data.clase[] object[]

meta[] string[] Plicul răspunsului: sursa, prospeţimea şi precizările care însoţesc datele.

data.clase[].clasa string Denumirea clasei, exact cum o publică BNR.

data.clase[].serii integer Câte serii temporale are clasa. Registrele NU sunt numărate aici.

data.clase[].valori integer Câte observaţii însumează seriile clasei.

data.clase[].prima_data string Prima observaţie din clasă. null la clasele fără valori.

data.clase[].ultima_data string Ultima observaţie din clasă. null la clasele fără valori.

Exemple de răspuns

GEThttps://oneapi.ro/api/financiar/v1/clase

{
    "data": {
        "clase": [
            {
                "clasa": "Arhivă a cursului de schimb (ROL) - serii anuale",
                "serii": 2,
                "valori": 28,
                "prima_data": "1985-01-01",
                "ultima_data": "2005-01-01"
            }
        ]
    },
    "meta": {
        "clase": 105,
        "sursa": "Banca Naţională a României — baza de date interactivă.",
        "nota": "Numărul de serii şi de valori acoperă doar seriile temporale; registrele nu sunt incluse."
    }
}

GEThttps://oneapi.ro/api/financiar/v1/clase?cauta=Cluj

{
    "data": {
        "clase": []
    },
    "meta": {
        "clase": 0,
        "sursa": "Banca Naţională a României — baza de date interactivă.",
        "cauta": "Cluj",
        "nota": "Numărul de serii şi de valori acoperă doar seriile temporale; registrele nu sunt incluse."
    }
}

GEThttps://oneapi.ro/api/financiar/v1/clase?cauta=credit

{
    "data": {
        "clase": [
            {
                "clasa": "Centrala Riscului de Credit - Credite acordate de IFN, instituţiile emitente de monedă electronică (IEME) şi instituţiile de plată (IP)",
                "serii": 45,
                "valori": 7125,
                "prima_data": "2009-12-01",
                "ultima_data": "2026-07-01"
            }
        ]
    },
    "meta": {
        "clase": 30,
        "sursa": "Banca Naţională a României — baza de date interactivă.",
        "cauta": "credit",
        "nota": "Numărul de serii şi de valori acoperă doar seriile temporale; registrele nu sunt incluse."
    }
}

Coduri de eroare

Cod	Slug	Când apare
401	neautentificat	Token lipsă sau invalid.
403	feature_indisponibil	`financiar.serii` nu e în planul curent.
422	validare	Un parametru nu a trecut validarea (`cauta`); `detalii` spune care şi de ce.
429	cota_depasita	Rata sau cota planului a fost depăşită.

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": "Un parametru nu a trecut validarea (cauta); detalii spune care şi de ce.",
        "detalii": {
            "cauta": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}