Fiets data API

Via deze API is het mogelijk om fiets data af te nemen. De API bestaat uit twee soorten endpoints:

• Data endpoints: om metingen voor fiets (geaggregeerd naar uren) op te halen voor een selectie van locaties. Deze API is in detail beschreven op https://dexter.ndw.nu/documentation/traffic-data/bicycle/
• GIS endpoint: om geografische informatie over (alle) fiets meetlocaties op te halen. Deze API is in detail beschreven op https://dexter.ndw.nu/documentation/static-road-data/bicycle/

Authenticatie

Authenticatie verloopt via OAuth. Bij aanroep van de API moet een “OAuth token” worden meegestuurd. Via de NDW Identity & Access Management server kan een dergelijk OAuth token verkregen worden. Hoewel het mogelijk om met een persoonlijk NDW account toegang te krijgen tot de API is het voor programmatische/systeem toegang aan te raden een zogenaamd service account te gebruiken. Een NDW service account voor de Fiets API kunt u aanvragen bij de NDW servicedesk. Vermeld bij contact duidelijk dat het gaat om een “service account voor afname van fiets data”.

Voorbeeld

Als u over een service account beschikt dan kan op de volgende wijze een OAuth token worden verkregen (via curl):

curl \
  -d "client_id=<uw client_id>" \
  -d "client_secret=<uw client secret>" \
  -d "grant_type=client_credentials" \
  https://iam.ndw.nu/auth/realms/ndw/protocol/openid-connect/token

Hierop volgt onderstaand response:

{
  "access_token": "",
  "expires_in": 1800,
  "refresh_expires_in": 3600,
  "refresh_token": "",
  "token_type": "Bearer",
  "not-before-policy": 0,
  "session_state": "81ae1763-9c99-4c54-99b8-5e0629f8a2d6",
  "scope": "profile email"
}

Het response bevat een access_token. De inhoud van dit access_token moet bij aanroep van de API worden meegestuurd. Dit kan middels de volgende HTTP header: Authorization: Bearer