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 Wink vartotojo paskyrą.
  2. Sukurkite filialo paskyrą. Ją reikės susieti su jūsų programa. Daugiau konteksto rasite skyriuje kas yra Studio.
  3. Sukurkite programą ir susiekite ją su filialo paskyra, sukurtą 2 žingsnyje. Serverio-serverio API integracijoms pasirinkite klientų tipą MACHINE_2_MACHINE.
  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 palaikomam kelionių inventoriaus tipui 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 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 ir spustelėkite mygtuką Get TOKEN.
  4. Jei jūsų kredencialai galioja, 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 atlikti 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 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 autentifikacijos skirtuke yra pasirinkta Inherit auth from parent, kad tokenas būtų pridėtas prie kiekvienos užklausos.