oneapi
Autentificare
Energie v1 / Sistemul energetic (SEN)

Seria observațiilor

Momentele NU sunt echidistante — vezi observația din răspuns înainte de a calcula medii.

GET
https://oneapi.ro/api/energie/v1/sen/serie

Parametri de interogare

NumeTipDescriereValori acceptate
de_laopțional string | null Primul moment inclus. Acceptă orice format de dată recunoscut. ex. 2026-09-04 00:00:00
pana_laopțional string | null Ultimul moment inclus. ex. 2026-09-04 23:59:59
limitaopțional integer | null Câte observații să întoarcă, maximum 1000. Implicit 100. 1 – 1000

Cum se comportă

  • Seria e formată din observații la momente neechidistante: se acumulează când rulează importul, nu la interval fix. Mediile de aici sunt medii peste observații, nu medii în timp, și nu se pot converti în energie (MWh) fără o serie la pas constant.
  • Pentru serii regulate, cu pas constant și istoric lung, sursa potrivită e ENTSO-E Transparency Platform — nu asta. Zona respectivă a modulului se construiește separat.
  • Ordinea e descrescătoare după moment. acoperire spune câte observații există și ce interval acoperă.

La ce folosește

  • Trasezi evoluția producției și a consumului peste observațiile acumulate.
  • Urmărești cum variază ponderea regenerabilelor de la o citire la alta.
  • Verifici ce interval acoperă datele înainte de a construi ceva pe ele.

Structura răspunsului

Toate câmpurile de mai jos sunt în data.

CâmpTipDescriere
inregistrari integer Câte observații conține răspunsul.
serie[].momentul string Momentul observației, în UTC.
serie[].sistem object Producția, consumul, soldul și procentul regenerabil la momentul acela.
serie[].sistem.productie_mw integer Producția totală a sistemului, în MW.
serie[].sistem.consum_mw integer Consumul total, în MW.
serie[].sistem.sold_mw integer Soldul schimburilor: NEGATIV = România exportă net, pozitiv = importă net.
serie[].sistem.directie_sold string export, import sau echilibru — citirea în clar a semnului.
serie[].sistem.regenerabil_procent number Ponderea hidro + eolian + fotovoltaic + biomasă în suma surselor citite.
serie[].productie_pe_sursa[] array Defalcarea pe sursă a producției din citirea respectivă.
serie[].productie_pe_sursa[].cod string Codul sursei (carbune_mw, fotovoltaic_mw…).
serie[].productie_pe_sursa[].denumire string Denumirea lizibilă.
serie[].productie_pe_sursa[].regenerabila boolean Dacă intră în ponderea regenerabilelor.
serie[].productie_pe_sursa[].valoare_mw integer Producția din acea sursă, în MW. Poate fi NEGATIVĂ la eolian.
acoperire.observatii integer Câte observații sunt în total în bază.
acoperire.prima string Cea mai veche observație.
acoperire.ultima string Cea mai recentă observație.
acoperire.regenerabil_mediu_procent number Media ponderii regenerabilelor peste toate observațiile.
acoperire.productie_minima_mw integer Cea mai mică producție observată.
acoperire.productie_maxima_mw integer Cea mai mare producție observată.
acoperire.consum_minim_mw integer Cel mai mic consum observat.
acoperire.consum_maxim_mw integer Cel mai mare consum observat.
observatie string Avertismentul despre observații neechidistante.
sursa object Sursa datelor, cu licența și observațiile ei.
sursa.nume string Sursa datelor.
sursa.url string Pagina sursei.
sursa.observatie string Temeiul publicării și precizarea că sursa nu publică termeni de reutilizare pentru acest flux.

Exemple de răspuns

GEThttps://oneapi.ro/api/energie/v1/sen/serie?limita=50
{
    "data": {
        "inregistrari": 13,
        "serie": [
            {
                "momentul": "2026-09-04 12: 13: 29+03",
                "sistem": {
                    "productie_mw": 5152,
                    "consum_mw": 4754,
                    "sold_mw": -398,
                    "directie_sold": "export",
                    "regenerabil_procent": 68.8
                },
                "productie_pe_sursa": [
                    {
                        "cod": "carbune_mw",
                        "denumire": "Cărbune",
                        "regenerabila": false,
                        "valoare_mw": 640
                    }
                ]
            }
        ],
        "acoperire": {
            "observatii": 13,
            "prima": "2026-09-04 11: 59: 46+03",
            "ultima": "2026-09-04 12: 13: 29+03",
            "regenerabil_mediu_procent": 69.13,
            "productie_minima_mw": 5145,
            "productie_maxima_mw": 5258,
            "consum_minim_mw": 4713,
            "consum_maxim_mw": 4817
        },
        "observatie": "Seria e formată din OBSERVAȚII, la momente neechidistante — se acumulează când rulează importul, nu la interval fix. Mediile de aici sunt medii peste observații, nu medii în timp, și NU se pot converti în energie (MWh) fără o serie la pas constant. Pentru serii regulate și istoric, sursa potrivită e ENTSO-E.",
        "sursa": {
            "nume": "Transelectrica — harta operativă a Sistemului Energetic Național",
            "url": "https://www.transelectrica.ro/",
            "observatie": "Date de transparență publicate în temeiul Regulamentului (UE) 543/2013. Transelectrica nu publică termeni de reutilizare pentru acest flux."
        }
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
422validarepana_la e înaintea lui de_la, sau limita depășește 1000.
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": "pana_la e înaintea lui de_la, sau limita depășește 1000.",
        "detalii": {
            "de_la": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}