oneapi
Autentificare
Energie v1 / Sistemul energetic (SEN)

Nomenclatorul modulului

Sursele de producție, punctele de interconexiune și convențiile de semn.

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

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

  • Fetch-uiește-l o dată și mapează local.
  • conventii e partea de citit cu atenție: aici scrie de ce soldul negativ înseamnă export, de ce eolianul poate fi negativ și pe ce se calculează procentul de regenerabile.
  • Cele 7 surse de producție și cele 24 de puncte de interconexiune sunt fixe în structura sursei. Dacă Transelectrica adaugă un tip de producție, importul se oprește la verificarea de bilanț în loc să servească date incomplete.

La ce folosește

  • Populezi legende și filtre cu exact codurile pe care le întorc celelalte rute.
  • Afli ce înseamnă semnul fiecărei mărimi înainte de a interpreta o cifră.
  • Verifici acoperirea datelor înainte de a cere o serie care ar veni goală.

Structura răspunsului

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

CâmpTipDescriere
surse_de_productie[] array Nomenclatorul surselor de producție, cu marcajul de regenerabil.
surse_de_productie[].cod string Codul sursei, așa cum apare în răspunsurile celorlalte rute.
surse_de_productie[].denumire string Denumirea lizibilă.
surse_de_productie[].regenerabila boolean Dacă intră în ponderea regenerabilelor.
puncte_de_interconexiune[] array Nomenclatorul punctelor de interconexiune, cu țara fiecăruia.
puncte_de_interconexiune[].punct string Codul punctului.
puncte_de_interconexiune[].denumire string Denumirea stației.
puncte_de_interconexiune[].tara string Țara vecină.
conventii object Ce înseamnă fiecare semn și fiecare procent din răspunsurile zonei — citește-le înainte de a interpreta un sold negativ.
conventii.sold_mw string Ce înseamnă semnul soldului.
conventii.flux_mw string Ce înseamnă semnul unui flux pe interconexiune.
conventii.eolian_mw string De ce eolianul poate fi negativ.
conventii.regenerabil_procent string Pe ce numitor se calculează procentul.
acoperire object Aceeași structură ca la /sen/serie.
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/surse
{
    "data": {
        "surse_de_productie": [
            {
                "cod": "carbune_mw",
                "denumire": "Cărbune",
                "regenerabila": false
            }
        ],
        "puncte_de_interconexiune": [
            {
                "punct": "MUKA",
                "denumire": "Mukacevo",
                "tara": "UA"
            }
        ],
        "conventii": {
            "sold_mw": "Negativ = România exportă net, pozitiv = importă net.",
            "flux_mw": "Pozitiv = import în România prin acel punct, negativ = export.",
            "eolian_mw": "Poate fi negativ: pe vânt slab, parcurile consumă din rețea. Nu e eroare și nu se trunchiază la zero.",
            "regenerabil_procent": "Ponderea hidro + eolian + fotovoltaic + biomasă în suma surselor citite de noi, nu în producția raportată — ca să rămână coerent dacă sursa adaugă un tip de producție pe care încă nu-l mapăm."
        },
        "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.
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."
    }
}