Skip to content
Academy

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 platformoje.
  2. Sukurkite kelionių agento paskyrą arba partnerio paskyrą.
  3. Sukurkite programą, susiedami ją su paskyra, sukurtą 2 žingsnyje.
  4. Sukūrę Application, saugiai išsaugokite client-id ir client secret.

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

Pažymėta eilutė rodo Cloudinary unikalų ID partners/radisson_blu_logo. Tai viskas, ko reikia, kad galėtumėte gauti 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 kelionių tikslus ar viešbučius.
  2. Kairėje naršymo juostoje spustelėkite Authentication.
  3. Įveskite savo client-id ir client secret, tada 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 autorizacijos skiltyje yra pasirinkta Inherit auth from parent, kad tokenas būtų pridėtas prie kiekvienos užklausos.