SW Platform · Roepnummer API 2.1

Roepnummerdata
zonder verkeerde kazerne.

De API koppelt een roepnummer niet meer blind aan een nummerblok. Een fysieke post, operationeel district en regionale functie zijn afzonderlijke gegevens, inclusief betrouwbaarheid en reviewstatus.

Datamodel

Standplaats ≠ inzetgebied.

station: fysieke thuisbasis, alleen wanneer die betrouwbaar bekend is.
assignment.scope: station, district, regional, reserve_pool, industrial of training.
operational_area: bijvoorbeeld Hart van Brabant Oost.
confidence: databetrouwbaarheid, kwaliteitsscore en reviewstatus.
station.group_code: fysieke post-/clustercode uit de bron, zoals 20-94; nadrukkelijk niet uniek.
assignment.callsign_block: automatisch afgeleid roepnummerblok, bijvoorbeeld 20-3092 → 20-30.
Handmatige correcties kunnen tegen volgende imports worden beschermd.

Landelijk 6.900+ canonieke identifiersREST compacte JSON + ETagAuth eigen API-key + rate limit

Resolve

Eén callsign

GET /roepnummers-api/v1/resolve?callsign=20-9471
X-API-Key: jouw-api-sleutel

{
  "station": {
    "name": "Tilburg Centrum",
    "physical": true,
    "confidence": "high"
  },
  "assignment": {
    "scope": "station"
  },
  "confidence": {
    "data": "high",
    "quality_score": 100
  }
}

Batch resolve

Resolve maximaal 100 roepnummers in één request; ideaal voor P2000-meldingen met meerdere voertuigen.

Delta-sync

/v1/changes?since=... geeft alleen gewijzigde records terug en gebruikt een cursor wanneer één sync meer dan 500 wijzigingen bevat.

Datakwaliteit

/v1/quality maakt zichtbaar hoeveel records nog review nodig hebben of een bronconflict kennen.

Endpoints

API 2.1

GET  /v1/resolve?callsign=20-9471
POST /v1/batch
GET  /v1/search?q=Tilburg
GET  /v1/units?region=20&group_code=20-94
GET  /v1/units?region=20&scope=district&callsign_block=20-30&confidence=high
GET  /v1/stations?region=20
GET  /v1/regions
GET  /v1/changes?since=2026-09-13T12:00:00+02:00
GET  /v1/quality
GET  /v1/stats
GET  /v1/health

Backwards compatible

Bestaande clients blijven werken.

De bestaande /v1/units, /v1/resolve, /v1/search, /v1/stats en /v1/health routes blijven bestaan. Responses bevatten extra velden; bestaande kernvelden blijven beschikbaar.

Elke API-key krijgt een eigen minuutlimiet. Rate-limitstatus wordt via responseheaders teruggegeven.

Bekijk platformstatus