Setup

In dit artikel leest u hoe u snel aan de slag kunt als ontwikkelaar en hoe u onze API’s op Wink kunt testen.

Opmerking

Testen moet altijd plaatsvinden in onzestaging-omgevingEr zijn weliswaar veel minder gegevens beschikbaar, maar u kunt zoveel testen als u wilt, zonder dat dit ten koste gaat van de productieomgeving.

Zodra u klaar bent om live te gaan, certificeren we uw account en uw applicatie en kunt u deze in onze productieomgeving lanceren.

Volg deze stappen:

1. Register uw gebruikersaccount op Wink
2. Maak een reisagentenaccount of een affiliate-account.
3. Een applicatie maken waar u het koppelt aan het account dat u in stap 2 hebt aangemaakt.
4. Zodra u uw Application, bewaar de client-id en het clientgeheim op een veilige plaats.

CDN

Bij Wink gebruiken we Cloudinary voor al onze beeld- en videomateriaal. Wanneer u onze reisinventaris opent, heeft u volledige toegang tot alle geavanceerde functies van Cloudinary.

Ons cloud_name is traveliko.

Cloudinary

• Aan de slag
• SDK’s
• Cloudinary op GitHub
• Video-tutorials

Voorbeeld

Voor elk type reisinventaris dat we ondersteunen, zal er een geneste JSON-array zijn met de naammultimediasDe 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": "Picture of the lobby",
      "language": "en"
    }
  ],
  "lifestyleType": "LIFESTYLE_BUSINESS",
  "attribution": [
    {
      "url": "https://www.hilton.com",
      "name": "Hilton"
    }
  ]
}

De gemarkeerde regel hierboven toont de unieke ID van Cloudinarypartners/radisson_blu_logoDat is alles wat u nodig hebt om de afbeelding in het gewenste formaat, kwaliteit en grootte op te halen.

Testen

Ga naar onzeAPI’sen kies de API waarmee u wilt werken.

API-documentatie

Onze documentatiesite is zo opgezet dat u API-opdrachten vanuit de site kunt uitvoeren.

In dit voorbeeld wilt u deSearch Lookups (OAuth2)API-oproep.

:::tip[Pro Tip] Voor gebruiksgemak raden we integrators aan de eindpunten te gebruiken die we alsOAuth2Deze eindpunten weten dat ze API-aanroepers kunnen verwachten en weten al op welk account u zich bevindt, zodat u de API-aanroeper niet hoeft op te geven.companyIdentifierin je URL’s. ::

1. Gebruik de Opzoek-API om bestemmingen of hotels op te halen.
2. Klik in de linker navigatiebalk op Authentication.
3. Voer uw client-id en clientgeheim in en klik op de Get TOKEN knop.
4. Als uw inloggegevens geldig zijn, ziet u dat uw API-sleutel is toegepast.
5. U kunt nu het opzoekeindpunt testen.

Voorbeeldzoekopdrachten (OAuth2)

Postbode

Je kunt hetzelfde doen met Postman.

1. Download Postbode.
2. Klik op Download OpenAPI spec vanaf de top van de Opzoek-API pagina.
3. Importeer het in Postman.
4. Als u het importeert als een nieuwe collectie met de naam Wink API, klik op de horizontale ellips (3 puntjes) naast de naam van de collectie en klik Edit.
5. In de Authorization tab, stel de Auth type naar OAuth2.
6. Stel het veld in Add auth data to naar Request headers.
7. Stel het veld in Header prefix naar Bearer.
8. Stel het veld in Token Name naar de naam die u aan uw opgeslagen token in Postman wilt geven. Bijvoorbeeld Wink Staging.
9. Stel het veld in Grant type naar Client Credentials.
10. Stel het veld in Access token URL naar https://staging-iam.wink.travel/oauth2/token.
11. Stel het veld in Client ID naar de client-ID die uw app heeft helpen genereren.
12. Stel het veld in Client Secret naar het clientgeheim dat uw app heeft helpen genereren.
13. Stel het veld in Scope naar inventory.read inventory.write inventory.removeDit zijn alle scopes die je nodig hebt voor Wink.
14. Stel het veld in Client Authentication naar Send as Basic Auth header.
15. Klik op de Get New Access Token knop om uw token op te halen en op te slaan.
16. Zorg ervoor dat voor alle API-aanroepen onder de Wink API-verzameling het tabblad Authenticatie het volgende aangeeft: Inherit auth from parent zodat bij elk gesprek uw token wordt meegestuurd.

:::tip[Pro Tip] Het is aan te raden om het serverdomein, de client-ID en het clientgeheim als omgevingsvariabelen te definiëren. Zo kunt u eenvoudig schakelen tussen staging- en productieomgevingen en alle bewerkingen die u hebt gemaakt, hergebruiken. :::