Endpoint:
GET https://api.public-warning.app/api/v1/providers/nl-alert/alerts
De app gebruikt uitsluitend de volgende velden:
| Veld | Type | Gebruik |
|---|---|---|
id |
string | deduplicatie en selectie |
message |
string | waarschuwingstekst |
type |
string | berichtsoort |
start_at |
ISO-datum | sortering en actieve status |
stop_at |
ISO-datum of null | actieve status |
area |
array van polygonen | afstand en strikt locatiefilter |
resource_uri |
string of null | eventuele aanvullende bron |
Een waarschuwing is actief wanneer start_at <= nu < stop_at. Bij een lege
stop_at blijft de waarschuwing actief totdat een opvolgend of ingetrokken
bericht wordt verwerkt.
De Toon-app valideert de noodzakelijke veldtypen, sorteert de geaccepteerde meldingen en begrenst het overzicht tot maximaal dertig regels. Een foutief antwoord wordt niet als waarschuwingstekst getoond.
Voor het eenmalig omzetten van een Nederlandse postcode naar een WGS84-punt gebruikt de Toon-app de openbare PDOK Locatieserver:
GET https://api.pdok.nl/bzk/locatieserver/search/v3_1/free
De zoekopdracht wordt beperkt tot type:postcode en de app leest alleen
postcode, woonplaatsnaam en centroide_ll. Het gevonden punt wordt lokaal
op Toon bewaard en daarna voor alle afstandsberekeningen gebruikt.