Skip to content
Academy

Seadistamine

See artikkel näitab, kuidas kiiresti arendajana seadistuda ja alustada meie API-de testimist Winkis.

Järgi neid samme:

  1. Registreeri oma kasutajakonto Winkis
  2. Loo reisibüroo konto või affiliate konto.
  3. Loo rakendus, kus seod selle kontoga, mille lõid sammus 2.
  4. Kui oled loonud oma Application, salvesta client-id ja client secret turvalisse kohta.

CDN

Section titled “CDN”

Winkis kasutame kõigi piltide ja videote jaoks Cloudinaryt. Kui pääsed ligi meie reisivarudele, on sul täielik ligipääs kõigile Cloudinary arenenud funktsioonidele.

Meie cloud_name on traveliko.

Cloudinary

Section titled “Cloudinary”

Näide

Section titled “Näide”

Iga toetatud reisivarude tüübi puhul on olemas pesastatud JSON-massiiv nimega multimedias. Multimeedia kirje JSON näeb välja selline:

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

Ülaltoodud esiletõstetud rida näitab Cloudinary unikaalset ID-d partners/radisson_blu_logo. See on kõik, mida vajad pildi hankimiseks mis tahes formaadis, kvaliteedis ja suuruses.

Testimine

Section titled “Testimine”

Mine meie API-de sektsiooni ja vali API, millega soovid töötada.

API dokumentatsioon

Section titled “API dokumentatsioon”

Meie dokumentatsioonisait on üles seatud nii, et saad API käske otse saidilt käivitada.

Selles näites soovid kasutada Search Lookups (OAuth2) API kõnet.

  1. Kasuta Lookup API-d sihtkohtade või hotellide pärimiseks.
  2. Vasakul navigeerimisribal klõpsa Authentication.
  3. Sisesta oma client-id ja client secret ning klõpsa Get TOKEN nuppu.
  4. Kui sinu volitused on kehtivad, näed, et sinu API võti on rakendatud.
  5. Nüüd saad testida lookup lõpp-punkti.
Lookup API lõpp-punkt
Näidis Search Lookups (OAuth2)

Postman

Section titled “Postman”

Sama saad teha ka Postmaniga.

  1. Laadi alla Postman.
  2. Klõpsa Download OpenAPI spec nupule Lookup API lehe ülaosas.
  3. Impordi see Postmani.
  4. Kui impordisid selle uue kollektsioonina nimega Wink API, klõpsa kollektsiooni nime kõrval horisontaalsele kolmele punktile ja vali Edit.
  5. Authorization vahekaardil sea Auth type väärtuseks OAuth2.
  6. Sea Add auth data to väärtuseks Request headers.
  7. Sea Header prefix väärtuseks Bearer.
  8. Sea Token Name väärtuseks, kuidas soovid oma salvestatud tokenit Postmanis nimetada, nt Wink Staging.
  9. Sea Grant type väärtuseks Client Credentials.
  10. Sea Access token URL väärtuseks https://staging-iam.wink.travel/oauth2/token.
  11. Sea Client ID väärtuseks Client ID, mille sinu rakendus aitas genereerida.
  12. Sea Client Secret väärtuseks Client Secret, mille sinu rakendus aitas genereerida.
  13. Sea Scope väärtuseks inventory.read inventory.write inventory.remove. Need on kõik Wink jaoks vajalikud õigused.
  14. Sea Client Authentication väärtuseks Send as Basic Auth header.
  15. Klõpsa Get New Access Token nuppu, et token kätte saada ja salvestada.
  16. Kõigi Wink API kollektsiooni all olevate API kõnede puhul veendu, et autentimise vahekaart ütleb Inherit auth from parent, et token lisatakse igale kõnele.