Aller au contenu

Setup

Cet article vous montre comment vous installer rapidement en tant que développeur et commencer à tester nos API sur Wink.

  1. Utilisez le API de recherche pour récupérer des destinations ou des hôtels.
  2. Dans la barre de navigation de gauche, cliquez sur Authentication.
  3. Saisissez votre identifiant client et votre secret client et cliquez sur le bouton Get TOKEN bouton.
  4. Si vos informations d’identification sont valides, vous verrez que votre clé API a été appliquée.
  5. Vous pouvez maintenant tester le point de terminaison de recherche.
Point de terminaison de l'API de recherche
Exemples de recherches (OAuth2)

Vous pouvez faire la même chose avec Postman.

  1. Télécharger Facteur.
  2. Cliquez sur Download OpenAPI spec du haut de la API de recherche page.
  3. Importez-le dans Postman.
  4. Si vous l’avez importé en tant que nouvelle collection appelée Wink API, cliquez sur les points de suspension horizontaux (3 points) à côté du nom de la collection et cliquez sur Edit.
  5. Dans le Authorization tab, définissez le Auth type à OAuth2.
  6. Définir le champ Add auth data to à Request headers.
  7. Définir le champ Header prefix à Bearer.
  8. Définir le champ Token Name Donnez le nom que vous souhaitez à votre jeton enregistré dans Postman. Par exemple, Wink Staging.
  9. Définir le champ Grant type à Client Credentials.
  10. Définir le champ Access token URL vers https://staging-iam.wink.travel/oauth2/token.
  11. Définir le champ Client ID à l’ID client que votre application a contribué à générer.
  12. Définir le champ Client Secret au secret client que votre application a contribué à générer.
  13. Définir le champ Scope à inventory.read inventory.write inventory.removeCe sont toutes les portées dont vous aurez besoin pour Wink.
  14. Définir le champ Client Authentication à Send as Basic Auth header.
  15. Cliquez sur le Get New Access Token bouton pour récupérer votre jeton et le sauvegarder.
  16. Pour tous les appels d’API sous la collection d’API Wink, assurez-vous que l’onglet d’authentification indique Inherit auth from parent il inclut donc votre jeton à chaque appel.

:::tip[Conseil de pro] Il est recommandé de définir le domaine du serveur, l’ID client et le secret client comme variables d’environnement. Ainsi, vous pourrez facilement passer de l’environnement de test à l’environnement de production et réutiliser toutes les opérations créées. :::