oneapi
Sign in
Mediu v1 / Avertizari

History coverage

Since when we accumulate warnings and how much we hold: how many messages, how many cancelled, how many zones and counties touched. The history starts when we began collecting, not at the source's beginning.

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

Query parameters

This route accepts no query parameters.

How it behaves

  • The route is free, like every coverage route on the platform.
  • istoricul_incepe_la is the most important field. The source feed has no archive: it holds only what is currently valid. Our history starts at the first import and grows from there — what was not captured can never be recovered.
  • ultima_verificare shows when we last saw the feed. If it falls far behind, the capture chain has stopped — and every hour of downtime is history permanently lost.

What it is for

  • Find out from which date you can ask questions about the past.
  • Check that the capture chain is actually running, by looking at the last check.

Response structure

All fields below live inside data.

FieldTypeDescription
avertizari integer How many warnings we have captured in total.
anulate integer How many were withdrawn by a later message.
zone integer How many warning-county pairs we have recorded.
judete_atinse integer How many distinct counties have ever been under warning since we started.
prima_avertizare string The start of the oldest validity window in the database.
ultima_avertizare string The end of the most recent one.
istoricul_incepe_la string The moment of our first import. There is nothing before it.
ultima_verificare string When we last saw the source feed.
observatie string A note on how to read the response: a computation convention or a limit of the data.
sursa object The source: MeteoAlarm (EUMETNET), the channel through which the Romanian meteorological service distributes its warnings in standardised CAP format. Includes issuer and licence.
sursa.nume string Name of the official source.
sursa.url string Public address of the source.
sursa.emitent string The institution that issued the information.
sursa.licenta string The licence under which the source allows reuse.
sursa.observatie string What to know about the source before using the data.

Response examples

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."
        }
    }
}

Error codes

CodeSlugWhen it occurs
401neautentificatToken missing, invalid, expired or revoked.
403modul_interzisThe token has no access to the route's module.
422validareThe route takes no parameters apart from lang: any other parameter returns 422 instead of being ignored.
429cota_depasitaThe plan's monthly quota has been exceeded (see Retry-After).

All errors share the same shape. eroare.cod is stable and is the value you should branch on in code — not the text in mesaj, which may change.

{
    "eroare": {
        "cod": "validare",
        "mesaj": "The route takes no parameters apart from lang: any other parameter returns 422 instead of being ignored."
    }
}