oneapi
Autentificare
Energie v1 / Sistemul energetic (SEN)

Starea sistemului acum

Producția pe sursă, consumul, soldul și fluxurile pe fiecare interconexiune, la ultima citire.

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

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

  • E un instantaneu, nu o medie. Transelectrica publică o citire momentană, iar noi o preluăm la rularea importului — nu continuu. Verifică vechime_minute și invechit înainte de a prezenta cifrele ca fiind „acum".
  • Eolianul poate fi negativ. Pe vânt slab, parcurile consumă din rețea în loc să producă. Nu e o eroare de citire și nu se trunchiază la zero — ar falsifica bilanțul.
  • Convenția de semn e uniformă: sold_mw negativ înseamnă că România exportă net, iar un flux_mw negativ pe o interconexiune înseamnă export prin acel punct. directie_sold și directie dau aceeași informație în clar, ca să nu depinzi de semn.
  • regenerabil_procent se raportează la suma surselor pe care le citim, nu la producția totală raportată de sursă. Dacă Transelectrica adaugă un tip de producție pe care încă nu-l mapăm, producția totală l-ar include iar suma noastră nu — și procentul ar ieși prea mare fără ca nimic să semnaleze.
  • Nuclearul poate fi 0: cele două grupe de la Cernavodă intră periodic în revizie. Nu e un câmp lipsă.

La ce folosește

  • Afișezi într-un dashboard cât produce România acum și din ce surse.
  • Urmărești ponderea regenerabilelor în timp real, pentru raportare sau pentru o decizie de consum.
  • Vezi pe ce interconexiuni se importă și pe care se exportă în acest moment.

Structura răspunsului

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

CâmpTipDescriere
momentul string Momentul citirii, în UTC. Sursa o publică în ora locală a României; conversia o facem noi.
vechime_minute integer De câte minute e veche citirea.
invechit boolean true peste 15 minute — nu o prezenta ca stare curentă.
sistem.productie_mw integer Producția totală a sistemului, în MW.
sistem.consum_mw integer Consumul total, în MW.
sistem.sold_mw integer Soldul schimburilor: NEGATIV = România exportă net, pozitiv = importă net.
sistem.directie_sold string export, import sau echilibru — citirea în clar a semnului.
sistem.regenerabil_procent number Ponderea hidro + eolian + fotovoltaic + biomasă în suma surselor citite.
productie_pe_sursa[].cod string Codul sursei (carbune_mw, fotovoltaic_mw…).
productie_pe_sursa[].denumire string Denumirea lizibilă.
productie_pe_sursa[].regenerabila boolean Dacă intră în ponderea regenerabilelor.
productie_pe_sursa[].valoare_mw integer Producția din acea sursă, în MW. Poate fi NEGATIVĂ la eolian.
interconexiuni[].punct string Codul punctului de interconexiune.
interconexiuni[].denumire string Denumirea stației.
interconexiuni[].tara string Țara vecină (ISO 3166-1 alpha-2).
interconexiuni[].flux_mw integer Fluxul instantaneu: pozitiv = import în România.
interconexiuni[].directie string import, export sau inactiv.
observatie string Avertismentul că e o citire momentană.
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/acum
{
    "data": {
        "momentul": "2026-09-04 12: 13: 29+03",
        "vechime_minute": 46766,
        "invechit": true,
        "derivat": false,
        "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
            }
        ],
        "interconexiuni": [
            {
                "punct": "DOBR",
                "denumire": "Dobrudja",
                "tara": "BG",
                "flux_mw": 55,
                "directie": "import"
            }
        ],
        "observatie": "Instantaneu, nu medie: valorile sunt citiri momentane publicate de Transelectrica, preluate de noi la rularea importului. Verifică `vechime_minute` înainte de a le prezenta ca fiind „acum\". Observaţiile cu `derivat: true` vin din perechea „acum 15 minute\" a unei citiri ulterioare: producţia e SUMA surselor (sursa nu publică un total pentru ele, abatere tipică sub 1%), iar soldul lipseşte — nu se poate calcula, fiindcă soldul raportat nu e exact consum minus producţie.",
        "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.
404negasitNu există încă nicio observație a stării SEN.
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": "negasit",
        "mesaj": "Nu există încă nicio observație a stării SEN."
    }
}