Siirry sisältöön

Pikakäynnistys

Tämä opas vie sinut noin 30 minuutissa nollasta toimivaan integraatioon. Lopuksi sinulla on:

  • hotellien reaaliaikaiset hinnat kaupungissa Partner API:sta,
  • varauslinkki, joka hyvittää varaukset tilillesi,
  • testivaraus ja webhook-ilmoitus varauksesta.

Kaikki tapahtuu staging-ympäristössä, testausympäristössämme. Sinun ei tarvitse pyytää meiltä pääsyä, eikä tuotantoon siirtyminen myöhemmin vaadi hyväksyntää.

Haluat…Aloita tästä
Näyttää hotelleja sovelluksessasi, sivustollasi tai tekoälytuotteessasi ja ohjata matkustajat varaamaan, ansaiten komissionTämä opas
Tehdä varauksia asiakkaidesi puolesta lisensoituna matkatoimistonaTämä opas vaiheeseen 5 asti, sitten Varaaminen matkatoimistona
Upottaa varattavia hotelleja ilman integraation kirjoittamistaWeb Components
Antaa tekoälyagentin hakea ja varataMCP Servers ja Agentic Payments
Yhdistää kanavahallinnan tai PMS:nLisää kanavahallintasi

Käytät Partner API:a löytääksesi hotellit ja niiden reaaliaikaiset hinnat. Jokaisella hotellilla on vakaa urlName. Muunnat sen linkiksi Wink Booking Engineen, book.wink.travel, joka välittää tunnisteesi. Matkustaja varaa ja maksaa siellä, ja varaus hyvitetään tilillesi.

Tarvitset:

  • grpcurl, tai Postmanin tai Insomnian. Partner API on gRPC, ei REST.
  • curl.

Staging on täysin erillinen tuotannosta, omilla kirjautumisilla ja tileillä.

  1. Mene osoitteeseen staging-app.wink.travel, klikkaa Sign-In / Register ja rekisteröidy.

  2. Klikkaa vasemmasta sivupalkista Accounts, sitten Create ja valitse I am an Affiliate. Lähettämäsi varaukset hyvitetään tälle tilille. Katso Luo tili.

Sovellus antaa koodillesi tunnistetiedot.

  1. Tilikortiltasi klikkaa Actions > Manage account, sitten Applications -välilehti.

  2. Klikkaa Create new application, anna nimi ja valitse asiakastyypiksi Machine-to-machine.

  3. Valitse scopes-kohdasta Inventory & rates (luku). Partner API tarkistaa inventory.read.

  4. Klikkaa Create application ja kopioi Client ID ja Client secret. Salaisuus näytetään vain kerran eikä sitä voi hakea myöhemmin.

Katso Applications muista asiakastyypeistä ja scopeista.

Terminal window
curl -X POST https://staging-iam.wink.travel/oauth2/token \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials" \
-d "client_id=<YOUR_CLIENT_ID>" \
-d "client_secret=<YOUR_CLIENT_SECRET>" \
-d "scope=inventory.read"

Tallenna vastauksesta access_token:

Terminal window
export WINK_TOKEN=<access_token>

Tunnukset vanhenevat. Omassa koodissasi anna OAuth2-kirjaston hakea ja päivittää ne. Katso Autentikointi.

Jos tunnuspyyntö hylätään, vastaus on JSON-runko, jossa on error-koodi:

errorHTTP-tilaTavallinen syy
invalid_client401Väärä client ID tai salaisuus, tai tuotantotunnuksia käytetty staging-iam:ssa
invalid_scope400Pyyntö pyytää scopea, johon sovellus ei ole rekisteröitynyt
unauthorized_client400Sovellus ei saa käyttää client_credentials -granttia
invalid_request400Pakollinen parametri puuttuu, esim. runko on JSON eikä lomake

Jokainen Partner API -kutsu nimeää tilin, jota edustat, managing-entity-id -otsikossa. Listaa tunnuksellasi hallittavat tilit:

Terminal window
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
-d '{}' \
staging-partner.wink.travel:443 wink.partner.v1.Accounts/ListAccounts

Kopioi vaiheessa 1 luodun affiliate-tilin accountId:

Terminal window
export WINK_ACCOUNT_ID=<accountId>

Stagingissa on testihotelleja, joissa on saatavuutta Bangkokissa, joten tässä haussa käytetään sen slugia, bangkok-thailand:

Terminal window
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
-H "managing-entity-id: $WINK_ACCOUNT_ID" \
-d '{
"urlName": "bangkok-thailand",
"userSession": {
"itinerary": {
"startDate": "2026-12-01",
"nights": 2,
"room": { "adults": 2 }
},
"currencyCode": "USD",
"languageCode": "en"
}
}' \
staging-partner.wink.travel:443 wink.partner.v1.Search/SearchByCity

Käytä tulevaa sisäänkirjautumispäivää; mennyt päivämäärä hylätään. Jokainen tulos sisältää:

  • name, starRating ja heroImageUrl, riittävästi tulosriville,
  • roomTypes, reaaliaikaiset tarjoukset, halvin huone ensin,
  • urlName, slug, jota tarvitset varauslinkkiin.

Hinnat ovat kokonaislukuina pienimmässä yksikössä: jaa vastausobjektin currencyExponent-arvon kymmenen potenssilla (USD:llä 2, joten 12500 on $125.00).

Et tiedä kaupungin slugia? Hae se wink.partner.v1.Lookup/Search-kutsulla. Kohteen koko sisältö löytyy Content-palvelusta. Partner API:n dokumentaatio kuvaa kaikki kutsut.

https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID>
  • <urlName> on hotellin urlName vaiheesta 5.
  • client-id on sovelluksesi Client ID vaiheesta 2.
  • configuration-id on mukautus-ID:si: Manage account > Customizations. Mukautus asettaa myös brändäyksen, oletuskielen ja valuutan varaus-sivulle.

Lisää matkustajan päivät, vieraat, kieli ja valuutta samaan linkkiin, jotta hotellisivu avautuu täytettynä:

https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID>&sd=2027-03-14&n=2&rc=a2&l=en&c=USD
ParametriMerkitysEsimerkki
sdSisäänkirjautumispäiväsd=2027-03-14
n tai edYöpymisten määrä tai uloskirjautumispäivän=2 tai ed=2027-03-16
rcVieraat per huonerc=a2 (2 aikuista)
lNäyttökielil=en
cNäyttövaluuttac=USD
pKampanjakoodip=ABC123

Nämä parametrit ohittavat mukautuksessasi asetetut oletukset. Varaa nyt -painikkeen opas kattaa koko rc-muodon, mukaan lukien lapset ja useat huoneet.

Linkki avaa hotellisivun; se ei voi valita huonetta tai hintaa etukäteen. Matkustaja valitsee huoneen hotellisivulla reaaliaikaisella hinnalla.

Katso Suora linkitys varausmoottorin kotisivulle linkittämisestä yksittäisen hotellin sijaan.

Avaa linkkisi, valitse päivät ja huone, ja maksa Stripe testikortilla, esimerkiksi 4242 4242 4242 4242 millä tahansa tulevalla voimassaolopäivällä ja CVC:llä. Stagingissa oikeaa korttia ei veloiteta. Huomaa varauskoodi vahvistussivulla; se alkaa WNK.

  1. Portaalissa mene kohtaan Applications > Webhooks ja lisää päätepiste, joka hyväksyy POST-pyynnöt.

  2. Tilaa booking.create -tapahtuma, tai jätä tapahtumalista tyhjäksi saadaksesi kaikki tapahtumat kehityksen aikana.

  3. Lähetä itsellesi testitapahtuma, tee toinen testivaraus ja seuraa sen saapumista.

Varmista jokaisen toimituksen allekirjoitus ennen kuin luotat siihen. Katso Webhook-integraatio ja Webhook-tapahtumaluettelo.

Kehittäjille ei ole hyväksyntävaihetta. (Matkatoimistotilit sertifioidaan ensin; katso alla.) Kun integraatiosi toimii stagingissa:

  1. Luo tili ja sovellus osoitteessa app.wink.travel kuten vaiheissa 1 ja 2. Tunnukset eivät siirry ympäristöjen välillä.

  2. Poista staging- kaikista isäntänimistä:

    StagingTuotanto
    https://staging-iam.wink.travelhttps://iam.wink.travel
    staging-partner.wink.travel:443partner.wink.travel:443
    https://staging-book.wink.travelhttps://book.wink.travel
  3. Hae tuotantotilin ID (vaihe 4) ja mukautus-ID (vaihe 6) uudelleen. Ne eroavat stagingista.

Partner API:n käyttö mitataan hotelliyöpymisinä, ja kuukausittain on ilmainen kiintiö. Katso Partner API hinnoittelusta ja rajoista.

Jos tilisi on lisensoitu matkatoimisto, sinun ei tarvitse ohjata matkustajia book.wink.travel -sivulle: voit tehdä varaukset suoraan wink.partner.v1.Booking/CreateBooking -kutsulla ja hallita niitä muilla Booking-kutsuilla. Muut tilit ohjaavat matkustajat varauslinkkiin.

Matkatoimistotilit sertifioidaan: Wink tarkistaa jokaisen toimiston rekisteröinnin ennen varausoikeuden myöntämistä. Toimistot, jotka haluavat kerätä maksut asiakkailtaan itse kauppiaana, on varattava Partner API:n kautta ja saatava Winkin kirjallinen hyväksyntä. Katso Aloittaminen matkatoimistona ja Partner API:n dokumentaatio.