☝️ Pour commencer, vous devez ajouter le plug-in API gratuit à votre portail. Vous pouvez en faire la demande auprès de notre service d'assistance via le chat ou à l'adresse [email protected].
💡 L’API Douano utilise le flux d’autorisation OAuth2 pour permettre l’accès à l’API. Vous trouverez plus d’explications via ce 👉 lien.
Générer un Client ID et un Secret
Pour lancer un flux d'autorisation OAuth2, vous devez créer un utilisateur API.
⇢ Allez dans Paramètres > API Publique > Intégrations API, puis créez une nouvelle intégration via le bouton plus vert 
Nom: Choisissez un nom pour cette intégration selon votre convenance.
URL de redirection: Récupérez-la depuis le logiciel externe qui doit être connecté à l'API Douano. Elle est nécessaire pour y envoyer le code d'autorisation.
Révoqué: Si vous souhaitez interrompre l'échange de données avec le logiciel externe, vous pouvez cocher cette option.
💡 Lorsque vous cliquez sur enregistrer et que vous rouvrez ensuite cette intégration, un Client ID et un Secret y seront générés.
Utiliser le Client ID et le Secret dans une application externe
Étape 1 : Demander l'accès (Authorization Flow)
Pour utiliser l'API, vous devez d'abord demander l'autorisation depuis votre application externe via le flux d'autorisation OAuth2.
URL d'autorisation :
https://<votre-douano-url>/authorizeType d'autorisation (Grant Type) : Utilisez Authorization code
Étape 2 : Obtenir l'Access Token & le Refresh Token
Dès que l'accès est approuvé, demandez un jeton d'accès via l'URL de jeton (token URL) :
URL du jeton (Token-URL) :
https://<votre-douano-url>/oauth/token
Après une demande réussie, vous recevrez deux clés de la part de Douano :
🔑 API Access Token (valable 1 jour) : Permet d'effectuer les véritables requêtes API.
🔄 API Refresh Token (valable 1 an) : Permet à votre application de demander automatiquement un nouvel Access Token chaque jour. Ainsi, vous n'avez pas besoin de refaire manuellement le flux d'autorisation tous les jours.
Postman – Documentation publique de l’API Douano
💡 Toutes les fonctionnalités de l’API Douano sont documentées dans Postman.
Cliquez sur ce 👉 lien pour ouvrir Postman.