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 matkatoimiston tili tai kumppanitili.
  3. Luo sovellus, jossa liität sen vaiheessa 2 luomaasi tiliin.
  4. Kun olet luonut Application-sovelluksesi, tallenna client-id ja client secret turvalliseen paikkaan.

CDN

Osio nimeltä “CDN”

Winkissä käytämme Cloudinarya kaikille kuville ja videoille. 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": "Aula",
      "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. Se on kaikki, mitä tarvitset kuvan hakemiseen missä tahansa muodossa, laadussa ja koossa.

Testaus

Osio nimeltä “Testaus”

Siirry API-rajapintojemme osioon ja valitse API, jota haluat käyttää.

API-dokumentaatio

Osio nimeltä “API-dokumentaatio”

Dokumentaatiosivustomme on järjestetty 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. Vasemman sivupalkin valikosta valitse 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 -päätepiste
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 tuot 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ään Add auth data to arvo Request headers.
  7. Aseta kenttään Header prefix arvo Bearer.
  8. Aseta kenttään Token Name haluamasi nimi tallennetulle tokenille Postmanissa, esim. Wink Staging.
  9. Aseta kenttään Grant type arvo Client Credentials.
  10. Aseta kenttään Access token URL arvo https://staging-iam.wink.travel/oauth2/token.
  11. Aseta kenttään Client ID sovelluksesi luoma Client ID.
  12. Aseta kenttään Client Secret sovelluksesi luoma Client Secret.
  13. Aseta kenttään Scope arvoksi inventory.read inventory.write inventory.remove. Nämä ovat kaikki Winkille tarvittavat oikeudet.
  14. Aseta kenttään Client Authentication arvo Send as Basic Auth header.
  15. Klikkaa Get New Access Token -painiketta hakeaksesi tokenin ja tallenna se.
  16. Kaikissa Wink API -kokoelman API-kutsuissa varmista, että autentikointivälilehdellä lukee Inherit auth from parent, jotta token sisältyy jokaiseen kutsuun.