Setup

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

Note

Les tests doivent toujours avoir lieu dans notreenvironnement de préparationIl y a beaucoup moins de données, mais vous êtes libre de tester autant que vous le souhaitez sans imposer à l’environnement de production.

Une fois que vous serez prêt à être opérationnel, nous certifierons votre compte et votre application, et vous pourrez les lancer dans notre environnement de production.

Suivez ces étapes :

1. Registre votre compte utilisateur sur Wink
2. Créer un compte d’agent de voyages ou un compte d’affiliation.
3. Créer une application où vous l’associez au compte que vous avez créé à l’étape 2.
4. Une fois que vous avez créé votre Application, enregistrez l’ID client et le secret client dans un endroit sûr.

CDN

Chez Wink, nous utilisons Cloudinary pour tous nos contenus photos et vidéos. En accédant à notre catalogue de voyages, vous bénéficierez d’un accès complet à toutes les fonctionnalités avancées de Cloudinary.

Notre cloud_name est traveliko.

Nuageux

• Commencer
• SDK
• Cloudinary sur GitHub
• Tutoriels vidéo

Exemple

Pour chaque type d’inventaire de voyage que nous prenons en charge, il y aura un tableau JSON imbriqué appelémultimediasLe JSON pour une entrée multimédia ressemble à ceci :

{
  "multimediaIdentifier": "multimedia-1",
  "identifier": "partners/radisson_blu_logo",
  "type": "IMAGE",
  "width": "1024",
  "height": "768",
  "category": "1",
  "descriptions": [
    {
      "name": "Lobby",
      "description": "Picture of the lobby",
      "language": "en"
    }
  ],
  "lifestyleType": "LIFESTYLE_BUSINESS",
  "attribution": [
    {
      "url": "https://www.hilton.com",
      "name": "Hilton"
    }
  ]
}

La ligne en surbrillance ci-dessus montre l’ID unique de Cloudinarypartners/radisson_blu_logoC’est tout ce dont vous avez besoin pour récupérer l’image dans le format, la qualité et la taille souhaités.

Essai

Rendez-vous sur notreApissection et choisissez l’API avec laquelle vous souhaitez travailler.

Documentation de l’API

Notre site de documentation est configuré de manière à ce que vous puissiez exécuter des commandes API à partir du site.

Dans cet exemple, vous souhaitez utiliser leSearch Lookups (OAuth2)Appel d’API.

:::tip[Conseil de pro] Pour une utilisation simplifiée, nous recommandons aux intégrateurs d’utiliser les points de terminaison que nous désignons commeOAuth2Ces points de terminaison savent s’attendre à des appelants d’API et savent déjà sur quel compte vous vous trouvez, vous n’avez donc pas besoin de spécifier lecompanyIdentifierdans vos URL.

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.

Exemples de recherches (OAuth2)

Facteur

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. :::