Gestion des utilisateurs
      Revenir à l'accueil
      2. Configurations
      3. Gestion des utilisateurs

      CREER UN UTILISATEUR API

      Créer votre compte développeur

      Pour pouvoir créer un utilisateur API sur votre compte Shippingbo, il vous faut en premier lieu créer votre compte développeur. Vous pouvez le créer en vous rendant sur le Dashboard développeur ici.

       

      Créer l'app

      Etape 1 : Une fois votre compte développeur créé, cliquez sur le bouton "New Application". 

      Puis, renseignez les informations suivantes : 

      - le nom de votre application

      - votre redirect URI : la localisation vers laquelle le serveur d'autorisation renvoi l'utilisateur une fois l'application autorisée, ainsi qu'un code d'autorisation. Le serveur d'authentification envoie le code ou le token vers le redirect URI, c'est pourquoi vous devez enregistrer la localisation exacte lors du processus d'enregistrement de votre application. Le format doit être le suivant : https://...

      Si vous souhaitez envoyer le token vers les en-têtes, vous pouvez utiliser cet URL : urn:ietf:wg:oauth:2.0:oob. 

      Puis, cliquez sur "Submit" : 

       

      Etape 2 : Cliquez sur "Authorize" pour autoriser la création de votre app :

        

       

      Créer l'Authentification avec Oauth

       

      Etape 1 : Effectuez l'authentification avec Oauth : le flux Oauth 2 avec votre application doit suivre ce schéma : 

       

      Etape 2 : Obtenir l'URL d'autorisation : cette dernière redirigera les utilisateurs vers la page d'autorisation Shippingbo contenant toutes les informations de votre app :

       

      Une fois autorisée par l'utilisateur, ce dernier sera redirigé vers le redirect URI avec le code d'autorisation. 

       

      Etape 2 : Récupérez le token d'accès : utilisez le code d'autorisation dans l'une des requêtes suivantes : 

      curl : 

       

      php : 

      ruby : 

       

      Etape 2 bis : Si le token d'accès est expiré, vous pouvez le rafraîchir avec les requêtes suivantes : 

      curl : 

      php : 

      ruby : 

       

      Etape 3 : Demandez une API Shippingbo. 

      Pour demander une API Shippingbo, il faut inclure 3 en-têtes dans votre requête : 

      • X-API-VERSION : version actuelle de l'API
      • X-API-ACCESS-TOKEN : le token obtenu lors de la requête précédente
      • X-API-ID : la valeur de votre app Shippingbo ID dans votre dashboard : 

      Remarque:
      Pour plus d'informations, n'hésitez pas à consulter notre documentation API ici.