Setup

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

Testauksen tulisi aina tapahtua meidänlavastusympäristöSiellä on paljon vähemmän dataa, mutta voit testata niin paljon kuin haluat rajoittamatta tuotantoympäristöä.

Kun olet valmis julkaisemaan sovelluksesi, sertifioimme tilisi ja sovelluksesi, ja voit julkaista sen tuotantoympäristössämme.

Noudata näitä ohjeita:

1. Rekisteröidy käyttäjätilisi Winkissä
2. Luo matkatoimiston tili tai kumppanitili.
3. Luo sovellus jossa liität sen vaiheessa 2 luomaasi tiliin.
4. Kun olet luonut oman Application, tallenna asiakastunnus ja asiakkaan salaisuus turvalliseen paikkaan.

CDN

Winkillä käytämme Cloudinarya kaikissa kuva- ja videoresursseissamme. Kun käytät matkakuvastoamme, saat täyden käyttöoikeuden kaikkiin Cloudinaryn edistyneisiin ominaisuuksiin.

Meidäncloud_nameontraveliko.

Pilviympäristö

• Aloittaminen
• SDK:t
• Cloudinary GitHubissa
• Video-oppaat

Esimerkki

Jokaiselle tukemallemme matkailuvarastotyypille on sisäkkäinen JSON-taulukko nimeltämultimediasMultimediamerkinnän JSON-tiedosto näyttää tältä:

{
  "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"
    }
  ]
}

Yllä oleva korostettu rivi näyttää Cloudinaryn yksilöllisen tunnuksenpartners/radisson_blu_logoSe on kaikki mitä tarvitset kuvan hakemiseen missä tahansa muodossa, laadussa ja koossa.

Testaus

Suuntaa meidänAPI-rajapinnatosiossa ja valitse API, jonka kanssa haluat työskennellä.

API-dokumentaatio

Dokumentaatiosivustomme on rakennettu siten, että voit suorittaa API-komentoja sivuston sisältä.

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

:::tip[Pro-vinkki] Käytön helpottamiseksi suosittelemme, että integraattorit käyttävät päätepisteitä, jotka olemme määrittäneetOAuth2Nuo päätepisteet osaavat odottaa API-kutsujia ja tietävät jo, millä tilillä olet, joten sinun ei tarvitse määrittääcompanyIdentifierURL-osoitteissasi. :::

1. Käytä Haku-API hakeaksesi kohteita tai hotelleja.
2. Napsauta vasemmassa navigointipalkissa Authentication.
3. Syötä asiakastunnuksesi ja asiakkaan salaisuus ja napsauta Get TOKEN painiketta.
4. Jos tunnistetietosi ovat kelvolliset, näet, että API-avaimesi on otettu käyttöön.
5. Voit nyt testata hakupäätepistettä.

Esimerkkihakuja (OAuth2)

Postinkantaja

Voit tehdä saman asian Postmanin kanssa.

1. Lataa Postinkantaja.
2. Klikkaa Download OpenAPI spec ylhäältä Haku-API sivu.
3. Tuo se Postmaniin.
4. Jos tuot sen uutena kokoelmana nimeltä Wink API, napsauta kokoelman nimen vieressä olevaa vaakasuoraa kolmea pistettä (kolme pistettä) ja napsauta Edit.
5. Sisään Authorization tab, aseta Auth type OAuth2:een.
6. Aseta kenttä Add auth data to että Request headers.
7. Aseta kenttä Header prefix että Bearer.
8. Aseta kenttä Token Name mihin tahansa haluat nimetä tallennetun tokenisi Postmanissa. Esim. Wink Staging.
9. Aseta kenttä Grant type että Client Credentials.
10. Aseta kenttä Access token URL osoitteeseen https://staging-iam.wink.travel/oauth2/token.
11. Aseta kenttä Client ID asiakastunnukseen, jonka luomisessa sovelluksesi oli mukana.
12. Aseta kenttä Client Secret asiakassalaisuuteen, jonka luomisessa sovelluksesi oli mukana.
13. Aseta kenttä Scope että inventory.read inventory.write inventory.removeNuo ovat kaikki Winkille tarvittavat laajuusalueet.
14. Aseta kenttä Client Authentication että Send as Basic Auth header.
15. Klikkaa Get New Access Token -painiketta noutaaksesi tunnuksesi ja tallentaaksesi sen.
16. Varmista, että kaikkien Wink API -kokoelman API-kutsujen kohdalla todennusvälilehdellä lukee Inherit auth from parent joten se sisällyttää tokenisi jokaisen kutsun mukana.

:::tip[Ammattilaisvinkki] On suositeltavaa tehdä palvelimen toimialue, asiakastunnus ja asiakkaan salaisuus ympäristömuuttujiksi. Tällä tavoin voit helposti vaihtaa testiympäristön ja tuotantoympäristön välillä ja käyttää uudelleen kaikkia luomiasi toimintoja. :::