Opsætning

Denne artikel viser dig, hvordan du hurtigt kommer i gang som udvikler og begynder at teste vores API’er på Wink.

Note

Testning bør altid foregå i vores staging-miljø. Der er langt færre data der, men du er fri til at teste så meget, du vil, uden at belaste produktionsmiljøet.

Når du er klar til at gå live, vil vi certificere din konto og din applikation, og du kan lancere i vores produktionsmiljø.

Følg disse trin:

1. Registrer din brugerkonto på Wink.
2. Opret en affiliate-konto. Du skal bruge denne til at knytte din applikation til. Se hvad er Studio for mere kontekst.
3. Opret en applikation og tilknyt den til den affiliate-konto, du oprettede i trin 2. For server-til-server API-integrationer skal du vælge MACHINE_2_MACHINE som klienttype.
4. Når du har oprettet din Application, skal du straks kopiere og gemme client-id og secret key — secret key vises kun én gang og kan ikke hentes igen.

CDN

Hos Wink bruger vi Cloudinary til alle vores billede- og videoressourcer. Når du får adgang til vores rejseinventar, får du fuld adgang til alle Cloudinarys avancerede funktioner.

Vores cloud_name er traveliko.

Cloudinary

• Kom godt i gang
• SDK’er
• Cloudinary på GitHub
• Video Tutorials

Eksempel

For hver type rejseinventar, vi understøtter, vil der være et indlejret JSON-array kaldet multimedias. JSON for en multimedia-post ser sådan ud:

{
  "multimediaIdentifier": "multimedia-1",
  "identifier": "partners/radisson_blu_logo",
  "type": "IMAGE",
  "width": "1024",
  "height": "768",
  "category": "1",
  "descriptions": [
    {
      "name": "Lobby",
      "description": "Billede af lobbyen",
      "language": "en"
    }
  ],
  "lifestyleType": "LIFESTYLE_BUSINESS",
  "attribution": [
    {
      "url": "https://www.hilton.com",
      "name": "Hilton"
    }
  ]
}

Den markerede linje ovenfor viser Cloudinarys unikke ID partners/radisson_blu_logo. Det er alt, hvad du behøver for at hente billedet i ethvert format, kvalitet og størrelse, du ønsker.

Testning

Gå til vores API’er sektion og vælg den API, du vil arbejde med.

API-dokumentation

Vores dokumentationsside er sat op, så du kan køre API-kommandoer direkte fra siden.

I dette eksempel vil du bruge Search Lookups (OAuth2) API-kaldet.

Pro Tip

For nemheds skyld anbefaler vi, at integratorer bruger de endpoints, vi betegner som OAuth2. Disse endpoints forventer API-kald og ved allerede, hvilken konto du er på, så du behøver ikke angive companyIdentifier i dine URL’er.

1. Brug Lookup API til at hente destinationer eller hoteller.
2. Klik på Authentication i venstre navigationsbjælke.
3. Indtast din client-id og client secret og klik på knappen Get TOKEN.
4. Hvis dine legitimationsoplysninger er gyldige, vil du se, at din API-nøgle er anvendt.
5. Du kan nu teste lookup-endpointet.

Eksempel på Search Lookups (OAuth2)

Postman

Du kan gøre det samme med Postman.

1. Download Postman.
2. Klik på Download OpenAPI spec øverst på Lookup API siden.
3. Importer det i Postman.
4. Hvis du importerede det som en ny samling kaldet Wink API, klik på de tre prikker ved siden af samlingsnavnet og vælg Edit.
5. I fanen Authorization skal du sætte Auth type til OAuth2.
6. Sæt feltet Add auth data to til Request headers.
7. Sæt feltet Header prefix til Bearer.
8. Sæt feltet Token Name til det navn, du vil give din gemte token i Postman, f.eks. Wink Staging.
9. Sæt feltet Grant type til Client Credentials.
10. Sæt feltet Access token URL til https://staging-iam.wink.travel/oauth2/token.
11. Sæt feltet Client ID til den Client ID, din app har genereret.
12. Sæt feltet Client Secret til den Client Secret, din app har genereret.
13. Sæt feltet Scope til inventory.read inventory.write inventory.remove. Det er alle de scopes, du skal bruge til Wink.
14. Sæt feltet Client Authentication til Send as Basic Auth header.
15. Klik på knappen Get New Access Token for at hente din token og gemme den.
16. For alle API-kald under Wink API-samlingen skal du sikre, at fanen for godkendelse siger Inherit auth from parent, så din token medtages ved hvert kald.

Pro Tip

Det anbefales at gøre serverdomæne, client ID og client secret til miljøvariabler. På den måde kan du nemt skifte mellem staging- og produktionsmiljøer og genbruge alle de operationer, du har oprettet.