RespondR

Publieke API

Integreer live meldingen en incidentdata in eigen tools. Deze pagina beschrijft alleen de publieke (niet-admin) API.

Authenticatie

Stuur je API-sleutel in de header X-Api-Key (of als queryparameter apiKey). Zonder sleutel gelden anonieme limieten op open endpoints.

API-sleutel aanvragen

Maak een account, open het dashboard → Account, en vraag een API-sleutel aan met een label en korte toelichting. Een beheerder activeert de sleutel; daarna zie je de prefix en kun je de volledige sleutel één keer ontvangen.

Open dashboard (Account)

Basis-URL

https://api.respondr.one

Limieten per account

Rate limits per minuut (globaal, per API-key/gebruiker): Anoniem ≈ 120 · Geregistreerd ≈ 600 · Premium ≈ 3000. Bodygrootte: anoniem 32 KB, geregistreerd 256 KB. Inbox-historie in de app/API volgt 7 / 30 / 60 dagen (free / registered / premium).

Open endpoints (zonder sleutel)

  • GET /api/feed/messages — recente meldingen (skip, take ≤ 200, since, filters).
  • GET /api/feed/messages/nearby — meldingen binnen radiusKm rond latitude/longitude.
  • GET /api/promo/feed en /api/promo/highlights — marketingfeed voor de website.

Endpoints met API-sleutel of login

  • GET /api/incidents — incidentoverzicht voor jouw account.
  • GET /api/emergency-messages/archive en /api/emergency-incidents/archive — archief binnen je planlimiet.
  • GET/POST /api/me/* — inbox, favorieten, tracker, capcodes, apparaten.
  • GET/POST /api/notifications — apparaatregistratie en notificatieregels.
  • GET /api/search — zoeken in referentiedata.
  • GET /api/identity/me · GET/POST /api/identity/api-keys — profiel en sleutelaanvraag.

Voorbeelden

curl -s "https://api.respondr.one/api/feed/messages?take=20&priorities=P1,P2"
curl -s "https://api.respondr.one/api/feed/messages/nearby?latitude=52.37&longitude=4.89&radiusKm=15&take=50"
curl -s -H "X-Api-Key: YOUR_KEY" "https://api.respondr.one/api/incidents"

Let op

Admin-API’s (/api/admin/…) en beheerderssleutels horen niet bij deze publieke documentatie en zijn niet bedoeld voor derden.

Station Hub-routes onder /api/station-hub zijn voor kazerneleden (login); ze vallen buiten deze publieke API-gids tenzij je zelf lid bent.