Oppsett
Denne artikkelen viser deg hvordan du raskt kommer i gang som utvikler og begynner å teste våre API-er på Wink.
Følg disse stegene:
- Registrer brukerkontoen din på Wink
- Opprett en reisebyråkonto eller en affiliate-konto.
- Opprett en applikasjon hvor du knytter den til kontoen du opprettet i steg 2.
- Når du har opprettet din
Application, lagre client-id og client secret på et trygt sted.
Hos Wink bruker vi Cloudinary for alle våre bilde- og videoressurser. Når du får tilgang til vår reiseinventar, vil du ha full tilgang til alle Cloudinarys avanserte funksjoner.
Vårt cloud_name er traveliko.
Cloudinary
Section titled “Cloudinary”Eksempel
Section titled “Eksempel”For hver type reiseinventar vi støtter, vil det være et nestet JSON-array kalt multimedias. JSON-en for en multimediaoppføring ser slik ut:
{ "multimediaIdentifier": "multimedia-1", "identifier": "partners/radisson_blu_logo", "type": "IMAGE", "width": "1024", "height": "768", "category": "1", "descriptions": [ { "name": "Lobby", "description": "Bilde av lobbyen", "language": "en" } ], "lifestyleType": "LIFESTYLE_BUSINESS", "attribution": [ { "url": "https://www.hilton.com", "name": "Hilton" } ]}Den uthevede linjen over viser Cloudinarys unike ID partners/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å til vår API-seksjon og velg API-et du vil jobbe med.
API-dokumentasjon
Section titled “API-dokumentasjon”Dokumentasjonsnettstedet vårt er satt opp slik at du kan kjøre API-kommandoer direkte fra siden.
I dette eksempelet vil du bruke Search Lookups (OAuth2) API-kallet.
- Bruk Lookup API for å hente destinasjoner eller hoteller.
- I venstre navigasjonsfelt, klikk på
Authentication. - Skriv inn din client-id og client secret og klikk på
Get TOKEN-knappen. - Hvis legitimasjonen din er gyldig, vil du se at API-nøkkelen din er aktivert.
- Du kan nå teste lookup-endepunktet.
Postman
Section titled “Postman”Du kan gjøre det samme med Postman.
- Last ned Postman.
- Klikk på
Download OpenAPI specøverst på Lookup API -siden. - Importer det til Postman.
- Hvis du importerte det som en ny samling kalt
Wink API, klikk på de horisontale ellipsene (3 prikker) ved siden av samlingsnavnet og velgEdit. - I
Authorization-fanen, settAuth typetil OAuth2. - Sett feltet
Add auth data totilRequest headers. - Sett feltet
Header prefixtilBearer. - Sett feltet
Token Nametil hva du vil kalle din lagrede token i Postman, f.eks. Wink Staging. - Sett feltet
Grant typetilClient Credentials. - Sett feltet
Access token URLtil https://staging-iam.wink.travel/oauth2/token. - Sett feltet
Client IDtil Client ID-en appen din genererte. - Sett feltet
Client Secrettil Client Secret-en appen din genererte. - Sett feltet
Scopetilinventory.read inventory.write inventory.remove. Dette er alle scopes du trenger for Wink. - Sett feltet
Client AuthenticationtilSend as Basic Auth header. - Klikk på
Get New Access Token-knappen for å hente token og lagre den. - For alle API-kall under Wink API-samlingen, sørg for at autentiseringsfanen sier
Inherit auth from parentslik at token inkluderes i hvert kall.