Ga naar inhoud
Academy

Installatie

Dit artikel laat je zien hoe je snel aan de slag kunt als ontwikkelaar en onze API’s op Wink kunt testen.

Volg deze stappen:

  1. Registreer je gebruikersaccount op Wink
  2. Maak een reisagentaccount of een affiliate-account aan.
  3. Maak een Applicatie aan en koppel deze aan het account dat je in stap 2 hebt aangemaakt.
  4. Zodra je je Application hebt aangemaakt, bewaar je de client-id en client secret op een veilige plek.

CDN

Section titled “CDN”

Bij Wink gebruiken we Cloudinary voor al onze beeld- en video-assets. Wanneer je toegang krijgt tot onze reisvoorraad, heb je volledige toegang tot alle geavanceerde functies van Cloudinary.

Onze cloud_name is traveliko.

Cloudinary

Section titled “Cloudinary”

Voorbeeld

Section titled “Voorbeeld”

Voor elk type reisvoorraad dat we ondersteunen, is er een geneste JSON-array genaamd multimedias. De JSON voor een multimedia-item ziet er als volgt uit:

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

De gemarkeerde regel hierboven toont de unieke Cloudinary ID partners/radisson_blu_logo. Dat is alles wat je nodig hebt om de afbeelding in elk formaat, kwaliteit en grootte op te halen.

Testen

Section titled “Testen”

Ga naar onze API’s sectie en kies de API waarmee je wilt werken.

API-documentatie

Section titled “API-documentatie”

Onze documentatiesite is zo opgezet dat je API-commando’s direct vanuit de site kunt uitvoeren.

In dit voorbeeld wil je de API-aanroep Search Lookups (OAuth2) gebruiken.

  1. Gebruik de Lookup API om bestemmingen of hotels op te halen.
  2. Klik in de linker navigatiebalk op Authentication.
  3. Voer je client-id en client secret in en klik op de knop Get TOKEN.
  4. Als je inloggegevens geldig zijn, zie je dat je API-sleutel is toegepast.
  5. Je kunt nu de lookup endpoint testen.
Lookup API endpoint
Voorbeeld Search Lookups (OAuth2)

Postman

Section titled “Postman”

Je kunt hetzelfde doen met Postman.

  1. Download Postman.
  2. Klik op Download OpenAPI spec bovenaan de Lookup API pagina.
  3. Importeer deze in Postman.
  4. Als je het hebt geïmporteerd als een nieuwe collectie genaamd Wink API, klik dan op de horizontale ellipsis (3 puntjes) naast de collectienaam en klik op Bewerken.
  5. Stel in het tabblad Authorization het Auth type in op OAuth2.
  6. Stel het veld Add auth data to in op Request headers.
  7. Stel het veld Header prefix in op Bearer.
  8. Geef het veld Token Name een naam naar keuze voor je opgeslagen token in Postman, bijvoorbeeld Wink Staging.
  9. Stel het veld Grant type in op Client Credentials.
  10. Stel het veld Access token URL in op https://staging-iam.wink.travel/oauth2/token.
  11. Stel het veld Client ID in op de Client ID die je app heeft gegenereerd.
  12. Stel het veld Client Secret in op de Client Secret die je app heeft gegenereerd.
  13. Stel het veld Scope in op inventory.read inventory.write inventory.remove. Dit zijn alle scopes die je voor Wink nodig hebt.
  14. Stel het veld Client Authentication in op Send as Basic Auth header.
  15. Klik op de knop Get New Access Token om je token op te halen en op te slaan.
  16. Zorg ervoor dat bij alle API-aanroepen onder de Wink API-collectie het authenticatietabblad zegt Inherit auth from parent, zodat je token bij elke oproep wordt meegestuurd.