Siirry sisältöön
Wink

Asennus

Tässä artikkelissa näytetään, miten pääset nopeasti alkuun kehittäjänä ja aloitat API-rajapintojemme testaamisen Winkissä.

Noudata näitä ohjeita:

  1. Rekisteröidy käyttäjätilillesi Winkissä.
  2. Luo affiliate-tili. Tarvitset tätä sitomaan sovelluksesi. Katso lisätietoja kohdasta mitä Studio on.
  3. Luo sovellus ja liitä se affiliate-tiliin, jonka loit kohdassa 2. Palvelin-palvelin API-integraatioissa valitse MACHINE_2_MACHINE asiakastyypiksi.
  4. Kun olet luonut Application-sovelluksesi, kopioi ja tallenna client-id ja salainen avain välittömästi — salainen avain näytetään vain kerran eikä sitä voi hakea uudelleen.

CDN

Osio nimeltä “CDN”

Winkissä käytämme Cloudinarya kaikissa kuvissa ja videoissa. Kun käytät matkavarantoamme, sinulla on täysi pääsy kaikkiin Cloudinaryn edistyneisiin ominaisuuksiin.

Meidän cloud_name on traveliko.

Cloudinary

Osio nimeltä “Cloudinary”

Esimerkki

Osio nimeltä “Esimerkki”

Jokaiselle tukemallemme matkavarannon tyypille on sisäkkäinen JSON-taulukko nimeltä multimedias. Multimedia-kohteen JSON näyttää tältä:

{
  "multimediaIdentifier": "multimedia-1",
  "identifier": "partners/radisson_blu_logo",
  "type": "IMAGE",
  "width": "1024",
  "height": "768",
  "category": "1",
  "descriptions": [
    {
      "name": "Lobby",
      "description": "Kuva aulasta",
      "language": "en"
    }
  ],
  "lifestyleType": "LIFESTYLE_BUSINESS",
  "attribution": [
    {
      "url": "https://www.hilton.com",
      "name": "Hilton"
    }
  ]
}

Korostettu rivi näyttää Cloudinaryn yksilöllisen tunnisteen partners/radisson_blu_logo. Tämä riittää hakemaan kuvan missä tahansa muodossa, laadussa ja koossa.

Testaus

Osio nimeltä “Testaus”

Siirry API-rajapintoihimme ja valitse haluamasi API.

API-dokumentaatio

Osio nimeltä “API-dokumentaatio”

Dokumentaatiosivustomme on rakennettu siten, että voit suorittaa API-komentoja suoraan sivustolta.

Tässä esimerkissä haluat käyttää Search Lookups (OAuth2) API-kutsua.

  1. Käytä Lookup API:a hakemaan kohteita tai hotelleja.
  2. Vasemmassa navigaatiopalkissa klikkaa Authentication.
  3. Syötä client-id ja client secret ja klikkaa Get TOKEN -painiketta.
  4. Jos tunnistetietosi ovat voimassa, näet, että API-avaimesi on otettu käyttöön.
  5. Voit nyt testata lookup-päätepistettä.
Lookup API endpoint
Esimerkkihaku Lookups (OAuth2)

Postman

Osio nimeltä “Postman”

Voit tehdä saman myös Postmanilla.

  1. Lataa Postman.
  2. Klikkaa Download OpenAPI spec Lookup API -sivun yläreunasta.
  3. Tuo se Postmaniin.
  4. Jos toit sen uutena kokoelmana nimeltä Wink API, klikkaa kokoelman nimen vieressä olevaa vaakasuoraa kolmen pisteen valikkoa ja valitse Edit.
  5. Authorization-välilehdellä aseta Auth type arvoksi OAuth2.
  6. Aseta kenttä Add auth data to arvoksi Request headers.
  7. Aseta kenttä Header prefix arvoksi Bearer.
  8. Aseta kenttä Token Name nimeksi, jolla haluat tallentaa tokenin Postmanissa, esim. Wink Staging.
  9. Aseta kenttä Grant type arvoksi Client Credentials.
  10. Aseta kenttä Access token URL arvoksi https://staging-iam.wink.travel/oauth2/token.
  11. Aseta kenttä Client ID sovelluksesi luoma Client ID.
  12. Aseta kenttä Client Secret sovelluksesi luoma Client Secret.
  13. Aseta kenttä Scope välilyönnillä erotetut käyttöoikeudet, joita integraatiosi tarvitsee (esim. inventory.read inventory.write inventory.remove). Katso scope-viite täydellisestä listasta.
  14. Aseta kenttä Client Authentication arvoksi Send as Basic Auth header.
  15. Klikkaa Get New Access Token -painiketta hakeaksesi tokenin ja tallentaaksesi sen.
  16. Kaikissa Wink API -kokoelman API-kutsuissa varmista, että autentikointivälilehti sanoo Inherit auth from parent, jotta token sisältyy jokaiseen kutsuun.