Financiar v1 / Meta

Meta / starea modulului

Ce seturi de date conţine modulul Financiar, cât acoperă fiecare şi cât de proaspete sunt.
Stările întârziate se raportează ca atare (stare: "in_urma"), nu se ascund.

GET

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

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Ce seturi de date conţine modulul Financiar, cât acoperă fiecare şi cât de proaspăt e.
Stările întârziate se raportează ca atare (stare: "in_urma"). Un set care nu mai primeşte date noi la sursă apare cu stare: "incheiata", nu ca eroare.
Ruta nu cere niciun feature din plan: e rută de descoperire, iar dacă ar fi închisă după plan, clientul n-ar putea afla ce conţine modulul înainte să cumpere.

La ce folosește

Verificarea prospeţimii înainte de a construi pe o serie anume.
Descoperirea seturilor disponibile şi a intervalului pe care îl acoperă.

Structura răspunsului

CâmpTipDescriere

data.modul string

data.versiune string Versiunea setului de date sau a artefactului din care vin valorile.

data.seturi[] object[]

meta.generat_la string Momentul la care s-a construit răspunsul (ISO 8601).

data.seturi[].cod string Identificatorul stabil al setului (curs_bnr, hicp, …). Nu se schimbă după publicare.

data.seturi[].sursa string Autoritatea care publică datele, aşa cum trebuie citată.

data.seturi[].acoperire object Prima şi ultima perioadă pentru care există date.

data.seturi[].entitati integer Câte lucruri distincte acoperă setul: valute, serii, categorii.

data.seturi[].valori integer Câte observaţii sunt stocate.

data.seturi[].stare string curenta = la zi; in_urma = sursa a publicat mai recent decât avem noi; incheiata = seria nu mai primeşte date noi.

Exemple de răspuns

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

{
    "data": {
        "modul": "financiar",
        "versiune": "v1",
        "seturi": [
            {
                "cod": "curs_bnr",
                "nume": "Curs de schimb BNR",
                "sursa": "Banca Naţională a României",
                "periodicitate": "zilnic",
                "acoperire": {
                    "de_la": "2005-01-03",
                    "pana_la": "2026-09-21"
                },
                "entitati": 40,
                "valori": 160124,
                "stare": "in_urma"
            }
        ]
    },
    "meta": {
        "generat_la": "2026-10-07T01: 57: 56+03: 00"
    }
}

Coduri de eroare

Cod	Slug	Când apare
401	neautentificat	Token lipsă sau invalid. E singura rută a modulului fără cerinţă de feature, deci un token valid o vede pe orice plan.
403	modul_interzis	Tokenul nu are acces la modulul rutei.
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": "neautentificat",
        "mesaj": "Token lipsă sau invalid. E singura rută a modulului fără cerinţă de feature, deci un token valid o vede pe orice plan."
    }
}