Mediu v1 / Avertizari

Tipuri și niveluri

Codurile pe care le folosesc avertizările: tipurile de fenomen (vânt, ninsoare, caniculă) şi nivelurile de severitate, cu denumirea fiecăruia.

GET

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

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Nomenclatorul e DERIVAT din ce am capturat efectiv, nu dintr-o listă scrisă de mână. Un tip de fenomen care n-a apărut încă în România nu figurează aici — iar asta e o informație despre datele noastre, nu despre standard.
Consecința practică: lista crește în timp. La început va conține doar vânt și ploaie; caniculă, ninsoare sau ger apar când se emit.

La ce folosește

Afli ce coduri poți trimite în filtrele tip și nivel.
Traduci un cod numeric primit într-o etichetă lizibilă.

Structura răspunsului

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

CâmpTipDescriere

tipuri[].cod integer Codul numeric al tipului de fenomen, cel folosit în filtru.

tipuri[].tip string Eticheta sursei (wind, rain…).

tipuri[].avertizari integer Câte avertizări de tipul ăsta am capturat până acum.

niveluri[].cod integer Codul nivelului (2 galben, 3 portocaliu, 4 roșu).

niveluri[].nivel string Culoarea.

niveluri[].severitate string Severitatea CAP corespunzătoare.

niveluri[].avertizari integer Câte avertizări de nivelul ăsta am capturat.

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/nomenclator

{
    "data": {
        "tipuri": [
            {
                "cod": 1,
                "tip": "wind",
                "avertizari": 3
            }
        ],
        "niveluri": [
            {
                "cod": 2,
                "nivel": "yellow",
                "severitate": "Moderate",
                "avertizari": 3
            }
        ],
        "observatie": "Nomenclatorul e DERIVAT din ce am capturat efectiv, nu dintr-o listă scrisă de mână. Un tip care n-a apărut încă în România nu figurează aici — iar asta e o informație despre datele noastre, nu despre standard.",
        "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	feature_indisponibil	Planul curent nu include funcţia de care ţine ruta.
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."
    }
}