Hitri začetek
Ta vodič vas v približno 30 minutah popelje od nič do delujoče integracije. Na koncu boste imeli:
- žive cene hotelov v mestu, iz Partner API-ja,
- povezavo za rezervacijo, ki pripiše rezervacije vašemu računu,
- testno rezervacijo in webhook, ki vas obvesti, da se je zgodila.
Vse se dogaja v staging okolju, našem testnem okolju. Ni vam treba prositi za dostop in kasnejši prehod v produkcijo ne zahteva odobritve.
Je ta vodič pravi za vas?
Section titled “Je ta vodič pravi za vas?”| Želite… | Začnite tukaj |
|---|---|
| Prikazovati hotele v vaši aplikaciji, spletnem mestu ali AI izdelku in poslati potnike k rezervaciji, da zaslužite provizijo | Ta vodič |
| Rezervirati v imenu svojih strank kot licencirana potovalna agencija | Ta vodič do koraka 5, nato Rezervacija kot potovalna agencija |
| Vdelati rezervabilne hotele brez pisanja integracije | Web Components |
| Dovoliti AI agentu, da išče in rezervira | MCP Servers in Agentic Payments |
| Povezati channel manager ali PMS | Dodajte svoj Channel Manager |
Kako deluje
Section titled “Kako deluje”Uporabite Partner API za iskanje hotelov in njihovih živih cen. Vsak hotel ima stabilno urlName. To spremenite v povezavo do Wink Booking Engine, book.wink.travel, ki nosi vaše ID-je. Potnik rezervira in plača tam, rezervacija pa se pripiše vašemu računu.
Preden začnete
Section titled “Preden začnete”Potrebovali boste:
grpcurl, ali Postman ali Insomnia. Partner API je gRPC, ne REST.curl.
Korak 1: Ustvarite staging račun
Section titled “Korak 1: Ustvarite staging račun”Staging je popolnoma ločen od produkcije, z lastnimi prijavami in računi.
-
Obiščite staging-app.wink.travel, kliknite
Sign-In / Registerin se registrirajte. -
Kliknite
Accountsv levem stranskem meniju, natoCreatein izberite I am an Affiliate. Rezervacije, ki jih pošljete, se pripišejo temu računu. Oglejte si Ustvarjanje računa.
Korak 2: Ustvarite aplikacijo
Section titled “Korak 2: Ustvarite aplikacijo”Aplikacija vašemu kodi zagotovi poverilnice.
-
Na kartici vašega računa kliknite
Actions>Manage account, nato zavihekApplications. -
Kliknite
Create new application, ji dajte ime in izberite Machine-to-machine kot tip odjemalca. -
Pod scopes izberite Inventory & rates (branje). Partner API preverja
inventory.read. -
Kliknite
Create applicationin kopirajte Client ID in Client secret. Skrivnost je prikazana samo enkrat in je ni mogoče pozneje pridobiti.
Oglejte si Applications za druge tipe odjemalcev in scopes.
Korak 3: Pridobite dostopni žeton
Section titled “Korak 3: Pridobite dostopni žeton”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"Shranjite access_token iz odgovora:
export WINK_TOKEN=<access_token>Žetoni potečejo. V lastni kodi naj OAuth2 knjižnica pridobi in osveži žetone. Oglejte si Avtentikacijo.
Če je zahteva za žeton zavrnjena, je odgovor JSON telo z error kodo:
error | HTTP status | Običajen vzrok |
|---|---|---|
invalid_client | 401 | Napačen Client ID ali skrivnost, ali so uporabljene produkcijske poverilnice na staging-iam |
invalid_scope | 400 | Zahteva za scope, za katerega aplikacija ni registrirana |
unauthorized_client | 400 | Aplikacija nima dovoljenja za uporabo client_credentials grant |
invalid_request | 400 | Manjka zahtevan parameter, na primer ko je telo JSON namesto obrazec |
Korak 4: Poiščite ID svojega računa
Section titled “Korak 4: Poiščite ID svojega računa”Vsak klic Partner API-ja navede račun, za katerega delujete, v glavi managing-entity-id. Naštejte račune, za katere lahko deluje vaš žeton:
grpcurl -H "authorization: Bearer $WINK_TOKEN" \ -d '{}' \ staging-partner.wink.travel:443 wink.partner.v1.Accounts/ListAccountsKopirajte accountId partnerskega računa iz koraka 1:
export WINK_ACCOUNT_ID=<accountId>Korak 5: Iščite hotele v mestu
Section titled “Korak 5: Iščite hotele v mestu”Staging ima testne hotele z razpoložljivostjo v Bangkoku, zato ta iskanje uporablja njegov slug, 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/SearchByCityUporabite prihodnji datum prijave; pretekli datum je zavrnjen. Vsak rezultat vsebuje:
name,starRatinginheroImageUrl, dovolj za prikaz vrstice rezultata,roomTypes, žive ponudbe, najcenejša soba prva,urlName, slug, ki ga potrebujete za povezavo do rezervacije.
Cene so cela števila v manjših enotah: delite z 10 na potenco currencyExponent iz odgovora (2 za USD, torej je 12500 $125,00).
Ne poznate sluga mesta? Poiščite ga z wink.partner.v1.Lookup/Search. Za celotno vsebino objekta uporabite storitev Content. Partner API referenca dokumentira vsak klic.
Korak 6: Sestavite povezavo za rezervacijo
Section titled “Korak 6: Sestavite povezavo za rezervacijo”https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID><urlName>jeurlNamehotela iz koraka 5.client-idje Client ID vaše aplikacije iz koraka 2.configuration-idje ID vaše prilagoditve:Manage account>Customizations. Prilagoditev nastavi tudi vašo blagovno znamko, privzeti jezik in valuto na strani za rezervacijo.
Posredujte iskanje potnika
Section titled “Posredujte iskanje potnika”Dodajte datume, goste, jezik in valuto potnika v isto povezavo, da se stran hotela odpre z izpolnjenimi podatki:
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| Parameter | Pomen | Primer |
|---|---|---|
sd | Datum prijave | sd=2027-03-14 |
n ali ed | Število noči ali datum odjave | n=2 ali ed=2027-03-16 |
rc | Gostje na sobo | rc=a2 (2 odrasla) |
l | Prikazni jezik | l=en |
c | Prikazna valuta | c=USD |
p | Promocijska koda | p=ABC123 |
Ti parametri preglasijo privzete nastavitve v vaši prilagoditvi. Vodič za gumb Rezerviraj zdaj pokriva celoten format rc, vključno z otroki in več sobami.
Povezava odpre stran hotela; ne more predizbrati sobe ali cene. Potnik izbere sobo na strani hotela po živi ceni.
Oglejte si Neposredno povezovanje za povezovanje na domačo stran rezervacijskega sistema namesto na posamezen hotel.
Korak 7: Naredite testno rezervacijo
Section titled “Korak 7: Naredite testno rezervacijo”Odprite svojo povezavo, izberite datume in sobo ter zaključite z testno kartico Stripe, na primer 4242 4242 4242 4242 z katerimkoli prihodnjim datumom poteka in katerimkoli CVC. V stagingu ni zaračunana nobena prava kartica. Zabeležite si kodo rezervacije na potrditveni strani; začne se z WNK.
Korak 8: Prejemajte obvestila o rezervacijah
Section titled “Korak 8: Prejemajte obvestila o rezervacijah”-
V Portalu pojdite na
Applications > Webhooksin dodajte končno točko, ki sprejemaPOSTzahteve. -
Naročite se na
booking.create, ali pustite seznam dogodkov prazen, da med razvojem prejmete vse. -
Pošljite si testni dogodek, nato naredite še eno testno rezervacijo in spremljajte njen prihod.
Pred zaupanjem preverite podpis vsake dostave. Oglejte si Integracijo webhookov in Katalog dogodkov webhookov.
Korak 9: Pojdite v produkcijo
Section titled “Korak 9: Pojdite v produkcijo”Za razvijalce ni koraka odobritve. (Računi potovalnih agencij so najprej certificirani; glejte spodaj.) Ko vaša integracija deluje v stagingu:
-
Ustvarite račun in aplikacijo na app.wink.travel, kot v korakih 1 in 2. Poverilnice se ne prenašajo med okolji.
-
Odstranite
staging-iz vseh gostiteljev:Staging Produkcija https://staging-iam.wink.travelhttps://iam.wink.travelstaging-partner.wink.travel:443partner.wink.travel:443https://staging-book.wink.travelhttps://book.wink.travel -
Ponovno poiščite svoj produkcijski ID računa (korak 4) in ID prilagoditve (korak 6). Razlikujeta se od staginga.
Uporaba Partner API-ja se meri v hotelskih nočitvah, z mesečnim brezplačnim limitom. Oglejte si Partner API za cene in omejitve.
Rezervacija kot potovalna agencija
Section titled “Rezervacija kot potovalna agencija”Če je vaš račun licencirana potovalna agencija, ni treba pošiljati potnikov na book.wink.travel: rezervacije lahko ustvarjate neposredno z wink.partner.v1.Booking/CreateBooking in jih upravljate z drugimi klici Booking. Drugi računi pošiljajo potnike na povezavo za rezervacijo.
Računi potovalnih agencij so certificirani: Wink pregleda registracijo vsake agencije, preden lahko rezervira. Agencije, ki želijo same pobirati plačila od svojih strank kot trgovec, morajo rezervirati prek Partner API-ja in pridobiti pisno odobritev Wink. Oglejte si Začetek kot potovalna agencija in Partner API referenco.
Naslednji koraki
Section titled “Naslednji koraki”- Generirajte tipiziranega odjemalca iz
.protosheme namesto ročnega klicagrpcurl. - Povežite MCP strežnik in uporabite AI Skills, da vaš kodirni pomočnik napiše integracijo proti živemu API-ju.
- Preberite celoten seznam okolij in gostiteljev.
