oneapi
Autentificare
Mediu v1 / Avertizari

Avertizări pentru un județ

Avertizările active într-un judeţ, cu nivelul maxim atins. Cu la se poate întreba cum era la o dată din trecut.

GET
https://oneapi.ro/api/mediu/v1/avertizari/judet/{cod}

Parametri de cale

NumeTipDescriereExemplu
codobligatoriu string Codul judeţului, două litere.

Parametri de interogare

NumeTipDescriereValori acceptate
laopțional string | null Momentul la care întrebi. Fără el, acum. ex. 2026-09-01
sirutaopțional integer | null Codul SIRUTA al unei localităţi din judeţ, ca să vezi numai avertizările care o acoperă. 1
nivelopțional integer | null Doar nivelul exact (2 galben, 3 portocaliu, 4 roșu). 1 – 4
nivel_minopțional integer | null Doar de la nivelul ăsta în sus — filtrul util pentru alertare. 1 – 4
tipopțional integer | null Codul tipului de fenomen, din /avertizari/nomenclator. 1 – 20
include_anulateopțional boolean | null 1 include și avertizările retrase. Implicit sunt excluse. ex. 1

Cum se comportă

  • Aceeași formă de răspuns ca ruta principală, cu filtrul pe județ deja aplicat.
  • Avertizările se emit PE JUDEȚ, deci ruta asta e granularitatea reală a sursei — nu o aproximare.

La ce folosește

  • Afișezi starea meteo pentru județul unui client, fără să filtrezi tu lista întreagă.
  • Verifici dacă o livrare programată mâine intră într-un județ sub avertizare.

Structura răspunsului

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

CâmpTipDescriere
moment string Momentul față de care s-a calculat valabilitatea.
acum boolean true dacă n-ai dat la, deci răspunsul e despre prezent.
inregistrari integer Câte avertizări acoperă județul atunci.
nivel_maxim null Cel mai grav nivel din județ la momentul cerut.
avertizari array Câte avertizări am capturat în total.
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.
avertizari[].identificator Identificatorul CAP, unic la nivel mondial. E cheia cu care ceri detaliul și cu care urmărești aceeași avertizare între cereri.
avertizari[].tip_mesaj Alert, Update sau Cancel. O anulare NU șterge nimic la noi — faptul că o avertizare a existat și a fost retrasă e el însuși informație.
avertizari[].anulata Dacă avertizarea a fost retrasă printr-un mesaj ulterior.
avertizari[].inlocuieste Identificatorii avertizărilor pe care acest mesaj le înlocuiește.
avertizari[].tip Tipul fenomenului: cod numeric plus eticheta sursei (wind, rain, snow-ice…).
avertizari[].nivel Nivelul de conștientizare: cod, culoare (yellow / orange / red) și severitatea CAP. Codul e stabil, eticheta e lizibilă — filtrează pe cod.
avertizari[].urgenta Cât de curând se așteaptă fenomenul (Immediate, Expected, Future).
avertizari[].certitudine Cât de sigur e că se va produce (Observed, Likely, Possible).
avertizari[].titlu Titlul oficial al avertizării, în română, exact cum l-a emis ANM.
avertizari[].descriere Textul avertizării. Netradus și nemodificat de noi.
avertizari[].instructiuni Recomandările emitentului, unde există.
avertizari[].valabilitate.de_la Când începe fenomenul (onset din CAP). Când sursa nu-l dă, se folosește momentul intrării în vigoare.
avertizari[].valabilitate.pana_la Când expiră avertizarea.
avertizari[].valabilitate.stare activa, viitoare, incheiata sau anulata. Se CALCULEAZĂ la fiecare cerere, față de ceas — nu e o coloană care ar putea rămâne în urmă.
avertizari[].valabilitate.ore_ramase Câte ore mai are de trăit avertizarea; null dacă s-a încheiat.
avertizari[].judete Județele acoperite: cod NUTS3 din sursă, denumirea ei a zonei, plus județul nostru cu indicativ auto și SIRUTA.
avertizari[].emis_la Când a fost emisă de ANM.
avertizari[].emitent Cine a emis-o — ANM.
avertizari[].vazuta_prima_data Când am capturat-o NOI prima oară. Diferența față de emis_la arată cât de repede am prins-o.

Exemple de răspuns

GEThttps://oneapi.ro/api/mediu/v1/avertizari/judet/CJ
{
    "data": {
        "moment": "2026-10-06T23: 39: 46+03: 00",
        "acum": true,
        "inregistrari": 0,
        "nivel_maxim": null,
        "avertizari": [],
        "observatie": "Nicio avertizare valabilă la momentul cerut. E rezultatul obișnuit: în cele mai multe zile nu există avertizări.",
        "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

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
404negasitNu există nimic pentru cod din cale.
422validareUn parametru nedeclarat ori o valoare care nu trece validarea (la, siruta, nivel, nivel_min, tip, include_anulate). Câmpul vinovat e în detalii.
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": "Un parametru nedeclarat ori o valoare care nu trece validarea (la, siruta, nivel, nivel_min, tip, include_anulate). Câmpul vinovat e în detalii.",
        "detalii": {
            "cod": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}