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:

1. Register brukerkontoen din på Wink
2. Opprett en reisebyråkonto eller en tilknyttet konto.
3. Opprett en applikasjon der du knytter den til kontoen du opprettet i trinn 2.
4. Når du har opprettet din Application, lagre klient-ID-en og klienthemmeligheten på et trygt sted.

CDN

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_nameertraveliko.

Cloudinary

• Komme i gang
• SDK-er
• Cloudinary på GitHub
• Videoopplæringer

Eksempel

For hver reisebeholdningstype vi støtter, vil det være en nestet JSON-matrise kaltmultimediasJSON-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_logoDet er alt du trenger for å hente bildet i hvilket som helst format, kvalitet og størrelse du ønsker.

Testing

Gå innom vårAPI-erseksjonen og velg API-et du vil jobbe med.

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 somOAuth2Disse endepunktene vet at de kan forvente API-anropere og vet allerede hvilken konto du er på, slik at du ikke trenger å spesifiserecompanyIdentifieri nettadressene dine. :::

1. Bruk Oppslags-API for å hente destinasjoner eller hoteller.
2. I venstre navigasjonsfelt klikker du på Authentication.
3. Skriv inn klient-ID-en og klienthemmeligheten din, og klikk på Get TOKEN knapp.
4. Hvis påloggingsinformasjonen din er gyldig, vil du se at API-nøkkelen din er brukt.
5. Du kan nå teste oppslagsendepunktet.

Eksempel på søkeoppslag (OAuth2)

Postbud

Du kan gjøre det samme med Postmannen.

1. Last ned Postbud.
2. Klikk på Download OpenAPI spec fra toppen av Oppslags-API side.
3. Importer den til Postman.
4. 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.
5. I Authorization tab, sett inn Auth type til OAuth2.
6. Angi feltet Add auth data to til Request headers.
7. Angi feltet Header prefix til Bearer.
8. Angi feltet Token Name til hva du enn vil kalle den lagrede tokenen din i Postman. F.eks. Wink Staging.
9. Angi feltet Grant type til Client Credentials.
10. Angi feltet Access token URL til https://staging-iam.wink.travel/oauth2/token.
11. Angi feltet Client ID til klient-ID-en appen din bidro til å generere.
12. Angi feltet Client Secret til klienthemmeligheten appen din bidro til å generere.
13. Angi feltet Scope til inventory.read inventory.write inventory.removeDet er alle omfangene du trenger for Wink.
14. Angi feltet Client Authentication til Send as Basic Auth header.
15. Klikk på Get New Access Token knappen for å hente tokenet ditt og lagre det.
16. 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. :::