Setup
Denne artikkelen viser deg hvordan du raskt kan komme i gang som utvikler og begynne å teste API-ene våre på Wink.
Testing bør alltid foregå i våroppsetningsmiljøDet er mye mindre data der, men du står fritt til å teste så mye du vil uten å belaste produksjonsmiljøet.
Når du er klar til å gå live, sertifiserer vi kontoen og applikasjonen din, og du kan lansere i produksjonsmiljøet vårt.
Følg disse trinnene:
- Register brukerkontoen din på Wink
- Opprett en reisebyråkonto eller en tilknyttet konto.
- Opprett en applikasjon der du knytter den til kontoen du opprettet i trinn 2.
- Når du har opprettet din
Application
, lagre klient-ID-en og klienthemmeligheten på et trygt sted.
Hos Wink bruker vi Cloudinary for alle våre bilde- og videoressurser. Når du får tilgang til reisekatalogen vår, har du full tilgang til alle Cloudinarys avanserte funksjoner.
Vårcloud_name
ertraveliko
.
Cloudinary
Section titled “Cloudinary”Eksempel
Section titled “Eksempel”For hver reisebeholdningstype vi støtter, vil det være en nestet JSON-matrise kaltmultimedias
JSON-filen for en multimedieoppføring ser slik ut:
{ "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 uthevede linjen ovenfor viser den unike ID-en til Cloudinarypartners/radisson_blu_logo
Det er alt du trenger for å hente bildet i hvilket som helst format, kvalitet og størrelse du ønsker.
Testing
Section titled “Testing”Gå innom vårAPI-erseksjonen og velg API-et du vil jobbe med.
API-dokumentasjon
Section titled “API-dokumentasjon”Dokumentasjonssiden vår er satt opp slik at du kan kjøre API-kommandoer fra nettstedet.
I dette eksemplet ønsker du å brukeSearch Lookups (OAuth2)
API-kall.
:::tips[Profftips]
For enkelhets skyld anbefaler vi at integratorer bruker endepunktene vi angir somOAuth2
Disse endepunktene vet at de kan forvente API-anropere og vet allerede hvilken konto du er på, slik at du ikke trenger å spesifiserecompanyIdentifier
i nettadressene dine.
:::
- Bruk Oppslags-API for å hente destinasjoner eller hoteller.
- I venstre navigasjonsfelt klikker du på
Authentication
. - Skriv inn klient-ID-en og klienthemmeligheten din, og klikk på
Get TOKEN
knapp. - Hvis påloggingsinformasjonen din er gyldig, vil du se at API-nøkkelen din er brukt.
- Du kan nå teste oppslagsendepunktet.
Postbud
Section titled “Postbud”Du kan gjøre det samme med Postmannen.
- Last ned Postbud.
- Klikk på
Download OpenAPI spec
fra toppen av Oppslags-API side. - Importer den til Postman.
- Hvis du importerte den som en ny samling kalt
Wink API
, klikk på den horisontale ellipsen (3 prikker) ved siden av samlingsnavnet og klikk påEdit
. - I
Authorization tab
, sett innAuth type
til OAuth2. - Angi feltet
Add auth data to
tilRequest headers
. - Angi feltet
Header prefix
tilBearer
. - Angi feltet
Token Name
til hva du enn vil kalle den lagrede tokenen din i Postman. F.eks. Wink Staging. - Angi feltet
Grant type
tilClient Credentials
. - Angi feltet
Access token URL
til https://staging-iam.wink.travel/oauth2/token. - Angi feltet
Client ID
til klient-ID-en appen din bidro til å generere. - Angi feltet
Client Secret
til klienthemmeligheten appen din bidro til å generere. - Angi feltet
Scope
tilinventory.read inventory.write inventory.remove
Det er alle omfangene du trenger for Wink. - Angi feltet
Client Authentication
tilSend as Basic Auth header
. - Klikk på
Get New Access Token
knappen for å hente tokenet ditt og lagre det. - For alle API-kall under Wink API-samlingen, sørg for at autentiseringsfanen sier
Inherit auth from parent
så den inkluderer tokenet ditt med hvert anrop.
:::tips[Profftips] Det anbefales å gjøre serverdomenet, klient-ID-en og klienthemmeligheten om til miljøvariabler. På den måten kan du enkelt bytte mellom oppstarts- og produksjonsmiljøer og bruke alle operasjonene du har opprettet på nytt. :::