Hoppa till innehåll
Academy

Installation

Den här artikeln visar hur du snabbt kommer igång som utvecklare och börjar testa våra API:er på Wink.

Följ dessa steg:

  1. Registrera ditt användarkonto på Wink
  2. Skapa ett resebyråkonto eller ett affiliate-konto.
  3. Skapa en applikation där du kopplar den till kontot du skapade i steg 2.
  4. När du har skapat din Application, spara client-id och client secret på en säker plats.

CDN

Section titled “CDN”

På Wink använder vi Cloudinary för alla våra bild- och videoresurser. När du får tillgång till vårt reseinventarium har du full tillgång till alla Cloudinarys avancerade funktioner.

Vårt cloud_name är traveliko.

Cloudinary

Section titled “Cloudinary”

Exempel

Section titled “Exempel”

För varje typ av reseinventarium vi stödjer finns en nästlad JSON-array som heter multimedias. JSON för en multimedia-post ser ut så här:

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

Den markerade raden ovan visar Cloudinarys unika ID partners/radisson_blu_logo. Det är allt du behöver för att hämta bilden i valfritt format, kvalitet och storlek.

Testning

Section titled “Testning”

Gå till vår API-sektion och välj det API du vill arbeta med.

API-dokumentation

Section titled “API-dokumentation”

Vår dokumentationssida är uppbyggd så att du kan köra API-kommandon direkt från sidan.

I detta exempel vill du använda API-anropet Search Lookups (OAuth2).

  1. Använd Lookup API för att hämta destinationer eller hotell.
  2. Klicka på Authentication i vänstra navigeringsfältet.
  3. Ange din client-id och client secret och klicka på knappen Get TOKEN.
  4. Om dina uppgifter är giltiga kommer du att se att din API-nyckel har tillämpats.
  5. Du kan nu testa lookup-endpointen.
Lookup API endpoint
Exempel på Search Lookups (OAuth2)

Postman

Section titled “Postman”

Du kan göra samma sak med Postman.

  1. Ladda ner Postman.
  2. Klicka på Download OpenAPI spec högst upp på sidan för Lookup API.
  3. Importera den till Postman.
  4. Om du importerade den som en ny samling kallad Wink API, klicka på de horisontella ellipserna (3 prickar) bredvid samlingsnamnet och välj Edit.
  5. I fliken Authorization, ställ in Auth type till OAuth2.
  6. Ställ in fältet Add auth data to till Request headers.
  7. Ställ in fältet Header prefix till Bearer.
  8. Ställ in fältet Token Name till vad du vill kalla din sparade token i Postman, t.ex. Wink Staging.
  9. Ställ in fältet Grant type till Client Credentials.
  10. Ställ in fältet Access token URL till https://staging-iam.wink.travel/oauth2/token.
  11. Ställ in fältet Client ID till det Client ID som din app hjälpte till att generera.
  12. Ställ in fältet Client Secret till det Client Secret som din app hjälpte till att generera.
  13. Ställ in fältet Scope till inventory.read inventory.write inventory.remove. Det är alla scopes du behöver för Wink.
  14. Ställ in fältet Client Authentication till Send as Basic Auth header.
  15. Klicka på knappen Get New Access Token för att hämta din token och spara den.
  16. För alla API-anrop under Wink API-samlingen, se till att autentiseringsfliken säger Inherit auth from parent så att din token inkluderas i varje anrop.