Configuration

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

Suivez ces étapes :

Enregistrez votre compte utilisateur sur Wink.
Créez un compte affilié. Vous en aurez besoin pour lier votre Application. Voir qu’est-ce que Studio pour plus de contexte.
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.
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 assets d’images et 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

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": "Picture of the lobby",
      "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).

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

Endpoint API Lookup — *Exemple de Search Lookups (OAuth2)*

Postman

Vous pouvez faire la même chose avec Postman.

Téléchargez Postman.
Cliquez sur Download OpenAPI spec en haut de la page de l’API Lookup.
Importez-le dans Postman.
Si vous l’avez importé en tant que nouvelle collection appelée Wink API, cliquez sur les ellipses horizontales (3 points) à côté du nom de la collection et cliquez sur Edit.
Dans l’onglet Authorization, définissez le Auth type sur OAuth2.
Réglez le champ Add auth data to sur Request headers.
Réglez le champ Header prefix sur Bearer.
Donnez un nom au champ Token Name pour votre token sauvegardé dans Postman, par exemple Wink Staging.
Réglez le champ Grant type sur Client Credentials.
Réglez le champ Access token URL sur https://staging-iam.wink.travel/oauth2/token.
Réglez le champ Client ID sur l’ID client généré par votre application.
Réglez le champ Client Secret sur le secret client généré par votre application.
Réglez le champ Scope sur les scopes délimités par des espaces dont votre intégration a besoin (ex. inventory.read inventory.write inventory.remove). Voir la référence des scopes pour la liste complète.
Réglez le champ Client Authentication sur Send as Basic Auth header.
Cliquez sur le bouton Get New Access Token pour récupérer votre token et le sauvegarder.
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.