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.
Volg deze stappen:
- Register uw gebruikersaccount op Wink
- Maak een reisagentenaccount of een affiliate-account.
- Een applicatie maken waar u het koppelt aan het account dat u in stap 2 hebt aangemaakt.
- Zodra u uw
Application
, bewaar de client-id en het clientgeheim op een veilige plaats.
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
Section titled “Cloudinary”Voorbeeld
Section titled “Voorbeeld”Voor elk type reisinventaris dat we ondersteunen, zal er een geneste JSON-array zijn met de naammultimedias
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": "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_logo
Dat is alles wat u nodig hebt om de afbeelding in het gewenste formaat, kwaliteit en grootte op te halen.
Testen
Section titled “Testen”Ga naar onzeAPI’sen kies de API waarmee u wilt werken.
API-documentatie
Section titled “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 alsOAuth2
Deze 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.companyIdentifier
in je URL’s.
::
- Gebruik de Opzoek-API om bestemmingen of hotels op te halen.
- Klik in de linker navigatiebalk op
Authentication
. - Voer uw client-id en clientgeheim in en klik op de
Get TOKEN
knop. - Als uw inloggegevens geldig zijn, ziet u dat uw API-sleutel is toegepast.
- U kunt nu het opzoekeindpunt testen.
Postbode
Section titled “Postbode”Je kunt hetzelfde doen met Postman.
- Download Postbode.
- Klik op
Download OpenAPI spec
vanaf de top van de Opzoek-API pagina. - Importeer het in Postman.
- 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 klikEdit
. - In de
Authorization tab
, stel deAuth type
naar OAuth2. - Stel het veld in
Add auth data to
naarRequest headers
. - Stel het veld in
Header prefix
naarBearer
. - Stel het veld in
Token Name
naar de naam die u aan uw opgeslagen token in Postman wilt geven. Bijvoorbeeld Wink Staging. - Stel het veld in
Grant type
naarClient Credentials
. - Stel het veld in
Access token URL
naar https://staging-iam.wink.travel/oauth2/token. - Stel het veld in
Client ID
naar de client-ID die uw app heeft helpen genereren. - Stel het veld in
Client Secret
naar het clientgeheim dat uw app heeft helpen genereren. - Stel het veld in
Scope
naarinventory.read inventory.write inventory.remove
Dit zijn alle scopes die je nodig hebt voor Wink. - Stel het veld in
Client Authentication
naarSend as Basic Auth header
. - Klik op de
Get New Access Token
knop om uw token op te halen en op te slaan. - 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. :::