Mediu v1 / Avertizari

Acoperirea istoricului

De când acumulăm avertizări şi cât avem: câte mesaje, câte anulate, câte zone şi judeţe atinse. Istoricul începe de când am pornit colectarea, nu de la începutul sursei.

GET

https://oneapi.ro/api/mediu/v1/avertizari/acoperire

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Ruta e gratuită, ca orice rută de acoperire din platformă.
istoricul_incepe_la e cel mai important câmp. Fluxul sursei nu are arhivă: conține doar ce e valabil acum. Istoricul nostru începe la primul import și crește de atunci — ce nu s-a capturat nu se poate recupera niciodată.
ultima_verificare arată când am văzut ultima oară fluxul. Dacă rămâne mult în urmă, lanțul de captură s-a oprit — și fiecare oră de oprire e istoric pierdut definitiv.

La ce folosește

Afli de la ce dată poți pune întrebări despre trecut.
Verifici că lanțul de captură chiar rulează, uitându-te la ultima verificare.

Structura răspunsului

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

CâmpTipDescriere

avertizari integer Câte avertizări am capturat în total.

anulate integer Câte au fost retrase printr-un mesaj ulterior.

zone integer Câte perechi avertizare-județ am înregistrat.

judete_atinse integer Câte județe distincte au fost vreodată sub avertizare de când acumulăm.

prima_avertizare string Începutul celei mai vechi ferestre de valabilitate din bază.

ultima_avertizare string Sfârșitul celei mai recente.

istoricul_incepe_la string Momentul primului nostru import. Nu există date înainte.

ultima_verificare string Când am văzut ultima oară fluxul sursei.

observatie string Precizare despre cum se citeşte răspunsul: o convenţie de calcul sau o limită a datelor.

sursa object Sursa: MeteoAlarm (EUMETNET), canalul prin care ANM își distribuie avertizările în format CAP standardizat. Include emitentul și licența.

sursa.nume string Denumirea sursei oficiale.

sursa.url string Adresa publică a sursei.

sursa.emitent string Instituţia care a emis informaţia.

sursa.licenta string Licenţa sub care sursa permite reutilizarea.

sursa.observatie string Ce trebuie ştiut despre sursă înainte de a folosi datele.

Exemple de răspuns

GEThttps://oneapi.ro/api/mediu/v1/avertizari/acoperire

{
    "data": {
        "avertizari": 3,
        "anulate": 0,
        "zone": 48,
        "judete_atinse": 26,
        "prima_avertizare": "2026-09-05 21: 00: 00+03",
        "ultima_avertizare": "2026-09-06 21: 00: 00+03",
        "istoricul_incepe_la": "2026-09-07 01: 57: 40+03",
        "ultima_verificare": "2026-09-07 01: 57: 40+03",
        "observatie": "Fluxul sursei NU are arhivă: conține doar ce e valabil acum. Istoricul nostru începe la primul import și crește de atunci — ce nu s-a capturat nu se poate recupera. De aceea `istoricul_incepe_la` e limita reală a oricărei întrebări despre trecut.",
        "sursa": {
            "nume": "MeteoAlarm (EUMETNET) — avertizări emise de Administrația Națională de Meteorologie",
            "url": "https://meteoalarm.org",
            "emitent": "Administrația Națională de Meteorologie (ANM)",
            "licenta": "MeteoAlarm: CC BY 4.0, cu atribuire către MeteoAlarm și ANM.",
            "observatie": "Avertizarea e emisă de ANM; MeteoAlarm e canalul EUMETNET prin care e distribuită în format CAP standardizat. Textul e cel oficial al ANM, netradus și nemodificat de noi."
        }
    }
}

Coduri de eroare

Cod	Slug	Când apare
401	neautentificat	Token lipsă, invalid, expirat sau revocat.
403	modul_interzis	Tokenul nu are acces la modulul rutei.
422	validare	Ruta nu primeşte parametri, în afară de `lang`: orice alt parametru dă 422, nu e ignorat.
429	cota_depasita	Cota 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."
    }
}