Configuration

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

Note

Les tests doivent toujours être effectués dans notre environnement de staging. Il y a beaucoup moins de données, mais vous êtes libre de tester autant que vous le souhaitez sans impacter l’environnement de production.

Une fois que vous êtes prêt à passer en production, nous certifierons votre compte et votre application, et vous pourrez lancer dans notre environnement de production.

Suivez ces étapes :

1. Enregistrez-vous en tant qu’utilisateur sur Wink.
2. Créez un compte affilié. Vous en aurez besoin pour lier votre Application. Consultez qu’est-ce que Studio pour plus de contexte.
3. Créez une Application et associez-la au compte affilié que vous avez créé à l’étape 2. Pour les intégrations API serveur-à-serveur, choisissez MACHINE_2_MACHINE comme type de client.
4. Une fois votre Application créée, copiez et sauvegardez immédiatement le client-id et la clé secrète — la clé secrète n’est affichée qu’une seule fois et ne peut pas être récupérée.

CDN

Chez Wink, nous utilisons Cloudinary pour tous nos actifs d’images et de vidéos. Lorsque vous accédez à notre inventaire de voyages, vous aurez un accès complet à toutes les fonctionnalités avancées de Cloudinary.

Notre cloud_name est traveliko.

Cloudinary

• Premiers pas
• SDKs
• Cloudinary sur GitHub
• Tutoriels vidéo

Exemple

Pour chaque type d’inventaire de voyage que nous supportons, il y aura un tableau JSON imbriqué appelé multimedias. Le 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": "Photo du hall",
      "language": "en"
    }
  ],
  "lifestyleType": "LIFESTYLE_BUSINESS",
  "attribution": [
    {
      "url": "https://www.hilton.com",
      "name": "Hilton"
    }
  ]
}

La ligne surlignée ci-dessus montre l’ID unique Cloudinary partners/radisson_blu_logo. C’est tout ce dont vous avez besoin pour récupérer l’image dans n’importe quel format, qualité et taille souhaités.

Tests

Rendez-vous dans notre section APIs et choisissez l’API avec laquelle vous souhaitez travailler.

Documentation API

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

Dans cet exemple, vous souhaitez utiliser l’appel API Search Lookups (OAuth2).

Astuce pro

Pour faciliter l’utilisation, nous recommandons aux intégrateurs d’utiliser les points de terminaison que nous désignons comme OAuth2. Ces points de terminaison savent qu’ils doivent s’attendre à des appels API et connaissent déjà le compte sur lequel vous êtes, vous n’avez donc pas à spécifier le companyIdentifier dans vos URLs.

1. Utilisez l’API Lookup pour récupérer des destinations ou des hôtels.
2. Dans la barre de navigation à gauche, cliquez sur Authentication.
3. Saisissez votre client-id et votre secret client, puis cliquez sur le bouton Get TOKEN.
4. Si vos identifiants sont valides, vous verrez que votre clé API a été appliquée.
5. Vous pouvez maintenant tester le point de terminaison lookup.

Exemple de Search Lookups (OAuth2)

Postman

Vous pouvez faire la même chose avec Postman.

1. Téléchargez Postman.
2. Cliquez sur Download OpenAPI spec en haut de la page de l’API Lookup.
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 l’onglet Authorization, définissez le Auth type sur OAuth2.
6. Réglez le champ Add auth data to sur Request headers.
7. Réglez le champ Header prefix sur Bearer.
8. Donnez un nom au champ Token Name pour nommer votre token sauvegardé dans Postman, par exemple Wink Staging.
9. Réglez le champ Grant type sur Client Credentials.
10. Réglez le champ Access token URL sur https://staging-iam.wink.travel/oauth2/token.
11. Réglez le champ Client ID sur l’ID client généré par votre application.
12. Réglez le champ Client Secret sur le secret client généré par votre application.
13. Réglez le champ Scope sur inventory.read inventory.write inventory.remove. Ce sont tous les scopes dont vous aurez besoin pour Wink.
14. Réglez le champ Client Authentication sur Send as Basic Auth header.
15. Cliquez sur le bouton Get New Access Token pour récupérer votre token et le sauvegarder.
16. Pour tous les appels API sous la collection Wink API, assurez-vous que l’onglet d’authentification indique Inherit auth from parent afin d’inclure votre token à chaque appel.

Astuce pro

Il est recommandé de transformer le domaine du serveur, le client ID et le client secret en variables d’environnement. Ainsi, vous pouvez facilement basculer entre les environnements de staging et de production et réutiliser toutes les opérations que vous avez créées.