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ää.
Onko tämä oikea opas sinulle?
Osio nimeltä “Onko tämä oikea opas sinulle?”| Haluat… | Aloita tästä |
|---|---|
| Näyttää hotelleja sovelluksessasi, sivustollasi tai tekoälytuotteessasi ja ohjata matkustajat varaamaan, ansaiten komission | Tämä opas |
| Tehdä varauksia asiakkaidesi puolesta lisensoituna matkatoimistona | Tämä opas vaiheeseen 5 asti, sitten Varaaminen matkatoimistona |
| Upottaa varattavia hotelleja ilman integraation kirjoittamista | Web Components |
| Antaa tekoälyagentin hakea ja varata | MCP Servers ja Agentic Payments |
| Yhdistää kanavahallinnan tai PMS:n | Lisää kanavahallintasi |
Miten se toimii
Osio nimeltä “Miten se toimii”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.
Ennen aloittamista
Osio nimeltä “Ennen aloittamista”Tarvitset:
grpcurl, tai Postmanin tai Insomnian. Partner API on gRPC, ei REST.curl.
Vaihe 1: Luo staging-tili
Osio nimeltä “Vaihe 1: Luo staging-tili”Staging on täysin erillinen tuotannosta, omilla kirjautumisilla ja tileillä.
-
Mene osoitteeseen staging-app.wink.travel, klikkaa
Sign-In / Registerja rekisteröidy. -
Klikkaa vasemmasta sivupalkista
Accounts, sittenCreateja valitse I am an Affiliate. Lähettämäsi varaukset hyvitetään tälle tilille. Katso Luo tili.
Vaihe 2: Luo sovellus
Osio nimeltä “Vaihe 2: Luo sovellus”Sovellus antaa koodillesi tunnistetiedot.
-
Tilikortiltasi klikkaa
Actions>Manage account, sittenApplications-välilehti. -
Klikkaa
Create new application, anna nimi ja valitse asiakastyypiksi Machine-to-machine. -
Valitse scopes-kohdasta Inventory & rates (luku). Partner API tarkistaa
inventory.read. -
Klikkaa
Create applicationja kopioi Client ID ja Client secret. Salaisuus näytetään vain kerran eikä sitä voi hakea myöhemmin.
Katso Applications muista asiakastyypeistä ja scopeista.
Vaihe 3: Hanki käyttöoikeustunnus
Osio nimeltä “Vaihe 3: Hanki käyttöoikeustunnus”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:
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:
error | HTTP-tila | Tavallinen syy |
|---|---|---|
invalid_client | 401 | Väärä client ID tai salaisuus, tai tuotantotunnuksia käytetty staging-iam:ssa |
invalid_scope | 400 | Pyyntö pyytää scopea, johon sovellus ei ole rekisteröitynyt |
unauthorized_client | 400 | Sovellus ei saa käyttää client_credentials -granttia |
invalid_request | 400 | Pakollinen parametri puuttuu, esim. runko on JSON eikä lomake |
Vaihe 4: Etsi tilisi ID
Osio nimeltä “Vaihe 4: Etsi tilisi ID”Jokainen Partner API -kutsu nimeää tilin, jota edustat, managing-entity-id -otsikossa. Listaa tunnuksellasi hallittavat tilit:
grpcurl -H "authorization: Bearer $WINK_TOKEN" \ -d '{}' \ staging-partner.wink.travel:443 wink.partner.v1.Accounts/ListAccountsKopioi vaiheessa 1 luodun affiliate-tilin accountId:
export WINK_ACCOUNT_ID=<accountId>Vaihe 5: Hae hotelleja kaupungista
Osio nimeltä “Vaihe 5: Hae hotelleja kaupungista”Stagingissa on testihotelleja, joissa on saatavuutta Bangkokissa, joten tässä haussa käytetään sen slugia, bangkok-thailand:
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/SearchByCityKäytä tulevaa sisäänkirjautumispäivää; mennyt päivämäärä hylätään. Jokainen tulos sisältää:
name,starRatingjaheroImageUrl, 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.
Vaihe 6: Rakenna varauslinkki
Osio nimeltä “Vaihe 6: Rakenna varauslinkki”https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID><urlName>on hotellinurlNamevaiheesta 5.client-idon sovelluksesi Client ID vaiheesta 2.configuration-idon mukautus-ID:si:Manage account>Customizations. Mukautus asettaa myös brändäyksen, oletuskielen ja valuutan varaus-sivulle.
Välitä matkustajan haku
Osio nimeltä “Välitä matkustajan haku”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| Parametri | Merkitys | Esimerkki |
|---|---|---|
sd | Sisäänkirjautumispäivä | sd=2027-03-14 |
n tai ed | Yöpymisten määrä tai uloskirjautumispäivä | n=2 tai ed=2027-03-16 |
rc | Vieraat per huone | rc=a2 (2 aikuista) |
l | Näyttökieli | l=en |
c | Näyttövaluutta | c=USD |
p | Kampanjakoodi | p=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.
Vaihe 7: Tee testivaraus
Osio nimeltä “Vaihe 7: Tee testivaraus”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.
Vaihe 8: Saat ilmoituksia varauksista
Osio nimeltä “Vaihe 8: Saat ilmoituksia varauksista”-
Portaalissa mene kohtaan
Applications > Webhooksja lisää päätepiste, joka hyväksyyPOST-pyynnöt. -
Tilaa
booking.create-tapahtuma, tai jätä tapahtumalista tyhjäksi saadaksesi kaikki tapahtumat kehityksen aikana. -
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.
Vaihe 9: Siirry tuotantoon
Osio nimeltä “Vaihe 9: Siirry tuotantoon”Kehittäjille ei ole hyväksyntävaihetta. (Matkatoimistotilit sertifioidaan ensin; katso alla.) Kun integraatiosi toimii stagingissa:
-
Luo tili ja sovellus osoitteessa app.wink.travel kuten vaiheissa 1 ja 2. Tunnukset eivät siirry ympäristöjen välillä.
-
Poista
staging-kaikista isäntänimistä:Staging Tuotanto https://staging-iam.wink.travelhttps://iam.wink.travelstaging-partner.wink.travel:443partner.wink.travel:443https://staging-book.wink.travelhttps://book.wink.travel -
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.
Varaaminen matkatoimistona
Osio nimeltä “Varaaminen matkatoimistona”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.
Seuraavat askeleet
Osio nimeltä “Seuraavat askeleet”- Luo tyypitetty asiakas
.proto-skeemasta sen sijaan, että kutsutgrpcurlia käsin. - Yhdistä MCP-palvelin ja käytä AI Skills saadaksesi koodausavustajan kirjoittamaan integraation live-API:lle.
- Lue täydellinen lista ympäristöistä ja isännistä.
