oneapi
Autentificare
Mediu v1 / Avertizari

Detaliul unei avertizări

O avertizare întreagă, după identificatorul ei CAP: textul, instrucţiunile, nivelul, perioada de valabilitate şi zonele acoperite.

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

Parametri de cale

NumeTipDescriereExemplu
identificatorobligatoriu string Identificatorul CAP al avertizării, aşa cum îl publică sursa.

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

  • Ruta întoarce avertizarea indiferent dacă mai e valabilă: și una încheiată, și una anulată se pot citi. Starea e în valabilitate.stare.
  • Identificatorii sunt cei CAP, exact cum îi dă sursa, și se obțin din celelalte rute ale zonei.

La ce folosește

  • Iei textul complet și lista de județe pornind de la un identificator primit în altă rută.
  • Verifici dacă o avertizare pe care ai acționat a fost între timp retrasă sau înlocuită.

Structura răspunsului

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

CâmpTipDescriere
avertizare.identificator string Identificatorul CAP, unic la nivel mondial. E cheia cu care ceri detaliul și cu care urmărești aceeași avertizare între cereri.
avertizare.tip_mesaj string 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.
avertizare.status string Starea elementului, aşa cum o publică sursa.
avertizare.anulata boolean Dacă avertizarea a fost retrasă printr-un mesaj ulterior.
avertizare.anulata_la null
avertizare.inlocuieste array Identificatorii avertizărilor pe care acest mesaj le înlocuiește.
avertizare.tip object Tipul fenomenului: cod numeric plus eticheta sursei (wind, rain, snow-ice…).
avertizare.tip.cod integer Codul din nomenclatorul sursei — cheia pe care se filtrează.
avertizare.tip.nume string Numele, aşa cum îl publică sursa.
avertizare.nivel object Nivelul de conștientizare: cod, culoare (yellow / orange / red) și severitatea CAP. Codul e stabil, eticheta e lizibilă — filtrează pe cod.
avertizare.nivel.cod integer Codul din nomenclatorul sursei — cheia pe care se filtrează.
avertizare.nivel.nume string Numele, aşa cum îl publică sursa.
avertizare.nivel.severitate string
avertizare.urgenta string Cât de curând se așteaptă fenomenul (Immediate, Expected, Future).
avertizare.certitudine string Cât de sigur e că se va produce (Observed, Likely, Possible).
avertizare.titlu string Titlul oficial al avertizării, în română, exact cum l-a emis ANM.
avertizare.descriere string Textul avertizării. Netradus și nemodificat de noi.
avertizare.instructiuni null Recomandările emitentului, unde există.
avertizare.valabilitate.de_la string Când începe fenomenul (onset din CAP). Când sursa nu-l dă, se folosește momentul intrării în vigoare.
avertizare.valabilitate.pana_la string Când expiră avertizarea.
avertizare.valabilitate.stare string 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ă.
avertizare.valabilitate.ore_ramase null Câte ore mai are de trăit avertizarea; null dacă s-a încheiat.
avertizare.judete[] array Județele acoperite: cod NUTS3 din sursă, denumirea ei a zonei, plus județul nostru cu indicativ auto și SIRUTA.
avertizare.judete[].nuts3 string
avertizare.judete[].zona string Zona la care se referă valoarea.
avertizare.judete[].judet string Judeţul la care se referă valoarea.
avertizare.judete[].judet_cod string Codul judeţului, două litere.
avertizare.judete[].cod_siruta integer Codul SIRUTA al unităţii teritoriale.
avertizare.emis_la string Când a fost emisă de ANM.
avertizare.emitent string Cine a emis-o — ANM.
avertizare.vazuta_prima_data string Când am capturat-o NOI prima oară. Diferența față de emis_la arată cât de repede am prins-o.
avertizare.web string
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/2.49.0.0.642.0.RO.2609050946.ed0abdb4ce97775e
{
    "data": {
        "avertizare": {
            "identificator": "2.49.0.0.642.0.RO.2609050946.ed0abdb4ce97775e",
            "tip_mesaj": "Alert",
            "status": "Actual",
            "anulata": false,
            "anulata_la": null,
            "inlocuieste": [],
            "tip": {
                "cod": 1,
                "nume": "wind"
            },
            "nivel": {
                "cod": 2,
                "nume": "yellow",
                "severitate": "Moderate"
            },
            "urgenta": "Future",
            "certitudine": "Likely",
            "titlu": "În zona montană înaltă vor fi rafale de peste 80-90 km/h.",
            "descriere": "În zona montană înaltă vor fi rafale de peste 80-90 km/h.",
            "instructiuni": null,
            "valabilitate": {
                "de_la": "2026-09-06T09: 00: 00+03: 00",
                "pana_la": "2026-09-06T21: 00: 00+03: 00",
                "stare": "incheiata",
                "ore_ramase": null
            },
            "judete": [
                {
                    "nuts3": "RO121",
                    "zona": "Alba",
                    "judet": "Alba",
                    "judet_cod": "AB",
                    "cod_siruta": 10
                }
            ],
            "emis_la": "2026-09-05T10: 09: 55+03: 00",
            "emitent": "ANM",
            "vazuta_prima_data": "2026-09-07T01: 57: 40+03: 00",
            "web": "http://www.meteoromania.ro"
        },
        "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ă avertizarea cu identificatorul dat.
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ă avertizarea cu identificatorul dat."
    }
}