☝️ Om hiermee te kunnen starten is het nodig om de gratis API plug-in toe te voegen aan je portaal. Dit kan je via onze support aanvragen via chat of [email protected].
💡 De Douano API maakt gebruik van de OAuth2 Authorization flow om toegang te verschaffen tot de API. Meer uitleg vind je terug via deze 👉 link.
Genereer een Client ID en Secret
Om met een OAuth2 Authorization flow te kunnen starten moet je een API gebruiker aanmaken.
⇢ Ga naar Instellingen - Publieke API - API integraties waar je een nieuwe integratie aanmaakt via de groene plus 
Naam: Kies een benaming voor deze integratie naar eigen keuze.
Redirect Url: deze haal je uit de externe software die aan de API van Douano dient gekoppeld te worden. Deze is nodig om de authorization code naartoe te sturen.
Ingetrokken: Indien je de gegevensuitwisseling wenst stop te zetten met de externe software kan je deze optie aanvinken.
💡 Wanneer je op opslaan klikt en deze integratie nadien weer opent zal deze voorzien zijn van een Client ID en Secret.
Gebruik de Client ID en Secret in een externe applicatie
Stap 1: Toegang aanvragen (Authorization Flow)
Om de API te gebruiken, vraag je eerst toestemming aan vanuit je externe applicatie met de OAuth2-authorisatie flow.
Authorisatie-URL:
https://<uw-douano-url>/authorizeGrant Type: Gebruik
Authorization code
Stap 2: Access Token & Refresh Token opvragen
Zodra de toegang is goedgekeurd, vraag je een toegangstoken op via de token-URL:
Token-URL:
https://<uw-douano-url>/oauth/token
Na een succesvolle aanvraag ontvang je twee sleutels van Douano:
🔑 API Access Token (1 dag geldig): Hiermee voer je de werkelijke API-verzoeken uit.
🔄 API Refresh Token (1 jaar geldig): Hiermee kan jouw applicatie automatisch dagelijks een nieuw Access Token aanvragen. Zo hoef je niet elke dag opnieuw handmatig door de authorisatie flow te gaan.
Postman - Douano Public API documentatie
💡 In Postman hebben we alle mogelijkheden van de Douano API gedocumenteerd. Klik op deze 👉 link om Postman te openen.