Skip to content
Wink

Nustatymas

Šiame straipsnyje parodyta, kaip greitai susikurti paskyrą kaip kūrėjas ir pradėti testuoti mūsų API Wink platformoje.

Sekite šiuos žingsnius:

  1. Užsiregistruokite Wink vartotojo paskyrai.
  2. Sukurkite filialo paskyrą. Jums jos reikės, kad susietumėte savo programą. Daugiau informacijos žr. kas yra Studio.
  3. Sukurkite programą ir susiekite ją su filialo paskyra, kurią sukūrėte 2 žingsnyje. Serverio-serverio API integracijoms pasirinkite MACHINE_2_MACHINE kaip kliento tipą.
  4. Sukūrę Application, nedelsdami nukopijuokite ir išsaugokite client-id ir slaptą raktą — slaptas raktas rodomas tik vieną kartą ir jo negalima atgauti.

CDN

Section titled “CDN”

Wink platformoje naudojame Cloudinary visiems mūsų vaizdų ir vaizdo įrašų ištekliams. Prisijungę prie mūsų kelionių inventoriaus, turėsite pilną prieigą prie visų Cloudinary pažangių funkcijų.

Mūsų cloud_name yra traveliko.

Cloudinary

Section titled “Cloudinary”

Pavyzdys

Section titled “Pavyzdys”

Kiekvienam kelionių inventoriaus tipui, kurį palaikome, bus įdėtas JSON masyvas pavadinimu multimedias. Multimedia įrašo JSON atrodo taip:

{
  "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"
    }
  ]
}

Paryškinta eilutė rodo Cloudinary unikalų ID partners/radisson_blu_logo. Tai viskas, ko jums reikia, kad gautumėte vaizdą bet kokiu formatu, kokybe ir dydžiu.

Testavimas

Section titled “Testavimas”

Eikite į mūsų API skyrių ir pasirinkite API, su kuria norite dirbti.

API dokumentacija

Section titled “API dokumentacija”

Mūsų dokumentacijos svetainė sukurta taip, kad galite vykdyti API užklausas tiesiogiai iš svetainės.

Šiame pavyzdyje norite naudoti Search Lookups (OAuth2) API užklausą.

  1. Naudokite Lookup API, kad gautumėte informaciją apie kelionės tikslus ar viešbučius.
  2. Kairėje naršymo juostoje spustelėkite Authentication.
  3. Įveskite savo client-id ir client secret ir spustelėkite mygtuką Get TOKEN.
  4. Jei jūsų duomenys teisingi, pamatysite, kad jūsų API raktas buvo pritaikytas.
  5. Dabar galite testuoti lookup galinį tašką.
Lookup API endpoint
Pavyzdinė Search Lookups (OAuth2)

Postman

Section titled “Postman”

Tą patį galite padaryti naudodami Postman.

  1. Atsisiųskite Postman.
  2. Spustelėkite Download OpenAPI spec viršuje Lookup API puslapyje.
  3. Importuokite jį į Postman.
  4. Jei importavote kaip naują kolekciją pavadinimu Wink API, spustelėkite horizontalią elipsę (3 taškai) šalia kolekcijos pavadinimo ir pasirinkite Edit.
  5. Skiltyje Authorization nustatykite Auth type į OAuth2.
  6. Lauke Add auth data to pasirinkite Request headers.
  7. Lauke Header prefix įrašykite Bearer.
  8. Lauke Token Name įrašykite norimą pavadinimą savo saugomam tokenui Postman. Pvz., Wink Staging.
  9. Lauke Grant type pasirinkite Client Credentials.
  10. Lauke Access token URL įrašykite https://staging-iam.wink.travel/oauth2/token.
  11. Lauke Client ID įrašykite savo programos sugeneruotą Client ID.
  12. Lauke Client Secret įrašykite savo programos sugeneruotą Client Secret.
  13. Lauke Scope įrašykite inventory.read inventory.write inventory.remove. Tai visi reikalingi Wink leidimai.
  14. Lauke Client Authentication pasirinkite Send as Basic Auth header.
  15. Spustelėkite mygtuką Get New Access Token, kad gautumėte ir išsaugotumėte tokeną.
  16. Visoms API užklausoms Wink API kolekcijoje įsitikinkite, kad autentifikacijos skirtuke yra pasirinkta Inherit auth from parent, kad tokenas būtų pridėtas prie kiekvienos užklausos.