Authenticatie

De authenticatie met de API server wordt gedaan middels een "token". Dit token kun je aanmaken via het portaal: tokens

Het aangemaakte token kan je vervolgens gebruiken als een bearer token, deze gebruik je in de Authorization HTTP Header:

Authorization: Bearer <token>

Voor meer informatie omtrent de Authorization header zie: https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/Authentication

Als de token incorrect of fout is dan wordt een HTTP/1.1 401 Unauthorized geretourneerd. Een verlopen token verlopen resulteert dit ook in een HTTP/1.1 401 Unauthorized .

Test je token

Je token kan je eenvoudig testen met een eenvoudige curl opdracht:

curl --header "Authorization: Bearer $JOUW_TOKEN" https://api.postcode-api.nl/v1/directmatch/nl/3811BN/26

De $JOUW_TOKEN is de token die je (reeds) hebt aangemaakt via het portaal op de tokens pagina.