Setup

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

Tester bör alltid ske i vårstaging-miljöDet finns mycket mindre data där, men du kan testa så mycket du vill utan att det påfrestar produktionsmiljön.

När du är redo att gå live certifierar vi ditt konto och din applikation och du kan lansera den i vår produktionsmiljö.

Följ dessa steg:

1. Register ditt användarkonto på Wink
2. Skapa en resebyråkonto eller en affiliate-konto.
3. Skapa en applikation där du kopplar det till kontot du skapade i steg 2.
4. När du har skapat din Application, spara klient-ID och klienthemligheten på ett säkert ställe.

CDN

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

Vårcloud_nameärtraveliko.

Molnigt

• Komma igång
• SDK:er
• Cloudinary på GitHub
• Videohandledningar

Exempel

För varje reseannonstyp vi stöder kommer det att finnas en kapslad JSON-matris som hetermultimediasJSON-filen för en multimediapost 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": "Picture of the lobby",
      "language": "en"
    }
  ],
  "lifestyleType": "LIFESTYLE_BUSINESS",
  "attribution": [
    {
      "url": "https://www.hilton.com",
      "name": "Hilton"
    }
  ]
}

Den markerade raden ovan visar Cloudinarys unika IDpartners/radisson_blu_logoDet är allt du behöver för att hämta bilden i vilket format, vilken kvalitet och storlek du vill.

Testning

Gå vidare till vårAPI:eroch välj det API du vill arbeta med.

API-dokumentation

Vår dokumentationssajt är konfigurerad på ett sådant sätt att du kan köra API-kommandon inifrån webbplatsen.

I det här exemplet vill du användaSearch Lookups (OAuth2)API-anrop.

:::tips[Proffstips] För enkel användning rekommenderar vi att integratörer använder de slutpunkter vi anger somOAuth2De slutpunkterna vet att de kan förvänta sig API-anropare och vet redan vilket konto du är på så att du inte behöver angecompanyIdentifieri dina webbadresser. :::

1. Använd Sök-API för att hämta destinationer eller hotell.
2. I den vänstra navigeringsfältet klickar du på Authentication.
3. Ange ditt klient-ID och din klienthemlighet och klicka på Get TOKEN knapp.
4. Om dina inloggningsuppgifter är giltiga ser du att din API-nyckel har tillämpats.
5. Nu kan du testa sökslutpunkten.

Exempel på söksökningar (OAuth2)

Brevbärare

Du kan göra samma sak med Postman.

1. Ladda ner Brevbärare.
2. Klicka på Download OpenAPI spec från toppen av Sök-API sida.
3. Importera den till Postman.
4. Om du importerade den som en ny samling som heter Wink API, klicka på det horisontella ellipset (3 punkter) bredvid samlingsnamnet och klicka på Edit.
5. I Authorization tab, 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 än vill döpa din sparade token till 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 klient-ID som din app hjälpte till att generera.
12. Ställ in fältet Client Secret till klienthemligheten som din app hjälpte till att generera.
13. Ställ in fältet Scope till inventory.read inventory.write inventory.removeDet är alla omfång du behöver för Wink.
14. Ställ in fältet Client Authentication till Send as Basic Auth header.
15. Klicka på Get New Access Token knappen för att hämta din token och spara den.
16. För alla API-anrop under Wink API-samlingen, se till att fliken autentisering anger Inherit auth from parent så det inkluderar din token med varje samtal.

:::tips[Proffstips] Det rekommenderas att göra serverdomänen, klient-ID:t och klienthemligheten till miljövariabler. På så sätt kan du enkelt växla mellan staging- och produktionsmiljöer och återanvända alla operationer du har skapat. :::