Setup
Denne artikel viser dig, hvordan du hurtigt kan oprette en udvikler og begynde at teste vores API’er på Wink.
:::bemærk Testning bør altid finde sted i voresstaging-miljøDer er meget mindre data der, men du kan frit teste så meget, du vil, uden at det pålægger produktionsmiljøet.
Når du er klar til at gå live, certificerer vi din konto og din applikation, og du kan lancere i vores produktionsmiljø. :::
Følg disse trin:
- Register din brugerkonto på Wink
- Opret en rejsebureaukonto eller en affiliate-konto.
- Opret en applikation hvor du knytter den til den konto, du oprettede i trin 2.
- Når du har oprettet din
Application
, gem klient-id’et og klienthemmeligheden et sikkert sted.
Hos Wink bruger vi Cloudinary til alle vores billed- og videomateriale. Når du tilgår vores rejsemateriale, har du fuld adgang til alle Cloudinarys avancerede funktioner.
Vorescloud_name
ertraveliko
.
Cloudinary
Section titled “Cloudinary”Eksempel
Section titled “Eksempel”For hver rejseopgørelsestype, vi understøtter, vil der være et indlejret JSON-array kaldetmultimedias
JSON-filen for en multimediepost ser sådan ud:
{ "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" } ]}
Den fremhævede linje ovenfor viser Cloudinarys unikke IDpartners/radisson_blu_logo
Det er alt, hvad du behøver for at hente billedet i det format, den kvalitet og den størrelse, du ønsker.
Testning
Section titled “Testning”Gå videre til voresAPI’ersektionen og vælg den API, du vil arbejde med.
API-dokumentation
Section titled “API-dokumentation”Vores dokumentationsside er konfigureret på en sådan måde, at du kan køre API-kommandoer indefra siden.
I dette eksempel vil du brugeSearch Lookups (OAuth2)
API-kald.
:::tip[Pro-tip]
For at gøre det nemmere at bruge, anbefaler vi, at integratorer bruger de slutpunkter, vi udpeger somOAuth2
Disse endpoints ved, at de kan forvente API-kaldere, og ved allerede, hvilken konto du er på, så du ikke behøver at angivecompanyIdentifier
i dine URL’er.
:::
- Brug Opslags-API for at hente destinationer eller hoteller.
- I venstre navigationslinje skal du klikke på
Authentication
. - Indtast dit klient-id og din klienthemmelighed, og klik på
Get TOKEN
knap. - Hvis dine loginoplysninger er gyldige, vil du se, at din API-nøgle er blevet anvendt.
- Du kan nu teste opslagsslutpunktet.
Postbud
Section titled “Postbud”Du kan gøre det samme med Postman.
- Download Postbud.
- Klik på
Download OpenAPI spec
fra toppen af Opslags-API side. - Importer det til Postman.
- Hvis du importerede den som en ny samling kaldet
Wink API
, klik på den vandrette elipse (3 prikker) ud for samlingsnavnet og klik påEdit
. - I
Authorization tab
, indstilAuth type
til OAuth2. - Indstil feltet
Add auth data to
tilRequest headers
. - Indstil feltet
Header prefix
tilBearer
. - Indstil feltet
Token Name
til hvad du nu vil navngive din gemte token i Postman. F.eks. Wink Staging. - Indstil feltet
Grant type
tilClient Credentials
. - Indstil feltet
Access token URL
til https://staging-iam.wink.travel/oauth2/token. - Indstil feltet
Client ID
til det klient-ID, som din app hjalp med at generere. - Indstil feltet
Client Secret
til den klienthemmelighed, som din app hjalp med at generere. - Indstil feltet
Scope
tilinventory.read inventory.write inventory.remove
Det er alle de scopes, du skal bruge til Wink. - Indstil feltet
Client Authentication
tilSend as Basic Auth header
. - Klik på
Get New Access Token
knappen for at hente din token og gemme den. - For alle API-kald under Wink API-samlingen skal du sørge for, at fanen godkendelse siger
Inherit auth from parent
så det inkluderer din token med hvert opkald.
:::tip[Pro-tip] Det anbefales at lave serverdomænet, klient-ID’et og klienthemmeligheden om til miljøvariabler. På den måde kan du nemt skifte mellem staging- og produktionsmiljøer og genbruge alle de operationer, du har oprettet. :::