Skip to content
Wink

Nustatymas

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

Sekite šiuos žingsnius:

  1. Užsiregistruokite vartotojo paskyrą Wink platformoje.
  2. Sukurkite filialo paskyrą. Ją reikės susieti su jūsų programa. Daugiau informacijos rasite skyriuje kas yra Studio.
  3. Sukurkite programą ir susiekite ją su filialo paskyra, sukurtą 2 žingsnyje. Serverio-serverio API integracijoms pasirinkite MACHINE_2_MACHINE kaip kliento tipą.
  4. Sukūrę Application, iš karto nukopijuokite ir išsaugokite klientų 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"
    }
  ]
}

Pažymėta eilutė rodo Cloudinary unikalų ID partners/radisson_blu_logo. Tai viskas, ko reikia, norint 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 svetainėje.

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

  1. Naudokite Lookup API, kad gautumėte paskirties vietas arba viešbučius.
  2. Kairėje naršymo juostoje spustelėkite Authentication.
  3. Įveskite savo klientų ID ir slaptą raktą, 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 ir su 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 klientų ID, kurį sugeneravo jūsų programa.
  12. Lauke Client Secret įrašykite slaptą raktą, kurį sugeneravo jūsų programa.
  13. Lauke Scope įrašykite tarpu atskirtus reikalingus integracijos leidimus (pvz., inventory.read inventory.write inventory.remove). Visą sąrašą rasite scope reference.
  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 skirtuke yra pasirinkta Inherit auth from parent, kad tokenas būtų pridėtas prie kiekvienos užklausos.