Siirry sisältöön
Academy

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

CDN

Osio nimeltä “CDN”

Winkissä käytämme Cloudinaryä 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. Se on kaikki, mitä tarvitset kuvan hakemiseen missä tahansa muodossa, laadussa ja koossa.

Testaus

Osio nimeltä “Testaus”

Siirry API-rajapintojemme osioon 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 hakeaksesi kohteita tai hotelleja.
  2. Vasemmasta navigaatiopalkista 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äosasta.
  3. Tuo se Postmaniin.
  4. Jos toit sen uutena kokoelmana nimeltä Wink API, klikkaa kokoelman nimen vieressä olevaa vaakapistevalikkoa (3 pistettä) ja valitse Edit.
  5. Authorization-välilehdellä aseta Auth type arvoksi OAuth2.
  6. Aseta kenttä Add auth data to arvoon Request headers.
  7. Aseta kenttä Header prefix arvoksi Bearer.
  8. Anna kentälle Token Name haluamasi nimi tallennetulle tokenille 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 arvoksi inventory.read inventory.write inventory.remove. Nämä ovat kaikki Winkille tarvittavat oikeudet.
  14. Aseta kenttä Client Authentication arvoksi 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älilehti sanoo Inherit auth from parent, jotta token sisältyy jokaiseen kutsuun.