Skip to content
Wink

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 sidusettevõtte konto. Seda vajad oma rakenduse sidumiseks. Vaata lisateavet mis on Studio.
  3. Loo rakendus ja seo see 2. sammus loodud sidusettevõtte kontoga. Serveri-serveri API integratsioonide puhul vali klienditüübiks MACHINE_2_MACHINE.
  4. Kui oled loonud oma Application, kopeeri ja salvesta kohe kliendi ID ja salajane võti — salajane võti kuvatakse ainult korra ja seda ei saa hiljem taastada.

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 Cloudinary kõigile täiustatud 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": "Picture of the lobby",
      "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 saidi sees 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 kliendi ID ja salajane võti 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 mis iganes soovid oma salvestatud tokenile Postmanis anda, 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 kliendi ID, mille sinu rakendus aitas genereerida.
  12. Sea Client Secret väärtuseks kliendi salajane võti, 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 autentimisvahekaart ütleb Inherit auth from parent, et token kaasatakse igasse kõnesse.