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:

1. Register din brugerkonto på Wink
2. Opret en rejsebureaukonto eller en affiliate-konto.
3. Opret en applikation hvor du knytter den til den konto, du oprettede i trin 2.
4. Når du har oprettet din Application, gem klient-id’et og klienthemmeligheden et sikkert sted.

CDN

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

Cloudinary

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

Eksempel

For hver rejseopgørelsestype, vi understøtter, vil der være et indlejret JSON-array kaldetmultimediasJSON-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_logoDet er alt, hvad du behøver for at hente billedet i det format, den kvalitet og den størrelse, du ønsker.

Testning

Gå videre til voresAPI’ersektionen og vælg den API, du vil arbejde med.

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 somOAuth2Disse endpoints ved, at de kan forvente API-kaldere, og ved allerede, hvilken konto du er på, så du ikke behøver at angivecompanyIdentifieri dine URL’er. :::

1. Brug Opslags-API for at hente destinationer eller hoteller.
2. I venstre navigationslinje skal du klikke på Authentication.
3. Indtast dit klient-id og din klienthemmelighed, og klik på Get TOKEN knap.
4. Hvis dine loginoplysninger er gyldige, vil du se, at din API-nøgle er blevet anvendt.
5. Du kan nu teste opslagsslutpunktet.

Eksempel på søgeopslag (OAuth2)

Postbud

Du kan gøre det samme med Postman.

1. Download Postbud.
2. Klik på Download OpenAPI spec fra toppen af Opslags-API side.
3. Importer det til Postman.
4. 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.
5. I Authorization tab, indstil Auth type til OAuth2.
6. Indstil feltet Add auth data to til Request headers.
7. Indstil feltet Header prefix til Bearer.
8. Indstil feltet Token Name til hvad du nu vil navngive din gemte token i Postman. F.eks. Wink Staging.
9. Indstil feltet Grant type til Client Credentials.
10. Indstil feltet Access token URL til https://staging-iam.wink.travel/oauth2/token.
11. Indstil feltet Client ID til det klient-ID, som din app hjalp med at generere.
12. Indstil feltet Client Secret til den klienthemmelighed, som din app hjalp med at generere.
13. Indstil feltet Scope til inventory.read inventory.write inventory.removeDet er alle de scopes, du skal bruge til Wink.
14. Indstil feltet Client Authentication til Send as Basic Auth header.
15. Klik på Get New Access Token knappen for at hente din token og gemme den.
16. 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. :::