Mabilisang Pagsisimula
Ang gabay na ito ay magdadala sa iyo mula wala hanggang sa gumaganang integrasyon sa loob ng mga 30 minuto. Sa katapusan ay magkakaroon ka ng:
- mga live na presyo para sa mga hotel sa isang lungsod, mula sa Partner API,
- isang link ng booking na nagbibigay ng kredito sa iyong account,
- isang test booking, at isang webhook na nagsasabi sa iyo na ito ay nangyari.
Lahat ng ito ay nangyayari sa staging, ang aming testing environment. Hindi mo kailangang humingi ng access sa amin, at ang paglipat sa production mamaya ay hindi rin nangangailangan ng pag-apruba.
Tama ba ang gabay na ito para sa iyo?
Section titled “Tama ba ang gabay na ito para sa iyo?”| Gusto mong… | Magsimula dito |
|---|---|
| Ipakita ang mga hotel sa iyong app, site o AI na produkto at ipadala ang mga biyahero upang mag-book, kumita ng komisyon | Ang gabay na ito |
| Mag-book para sa iyong mga kliyente bilang isang lisensyadong travel agency | Ang gabay na ito hanggang Step 5, pagkatapos ay Booking bilang isang travel agency |
| I-embed ang mga hotel na maaaring i-book nang hindi nagsusulat ng integrasyon | Web Components |
| Hayaan ang isang AI agent na maghanap at mag-book | MCP Servers at Agentic Payments |
| Ikonekta ang isang channel manager o PMS | Idagdag ang Iyong Channel Manager |
Paano ito gumagana
Section titled “Paano ito gumagana”Ginagamit mo ang Partner API upang hanapin ang mga hotel at ang kanilang mga live na presyo. Bawat hotel ay may matatag na urlName. Ginagawa mo itong link papunta sa Wink Booking Engine, book.wink.travel, na may dala mong mga ID. Ang biyahero ay magbu-book at magbabayad doon, at ang booking ay makikilala sa iyong account.
Bago ka magsimula
Section titled “Bago ka magsimula”Kakailanganin mo:
grpcurl, o Postman o Insomnia. Ang Partner API ay gRPC, hindi REST.curl.
Step 1: Gumawa ng staging account
Section titled “Step 1: Gumawa ng staging account”Ang staging ay ganap na hiwalay sa production, na may sarili nitong mga login at account.
-
Pumunta sa staging-app.wink.travel, i-click ang
Sign-In / Registerat magrehistro. -
I-click ang
Accountssa kaliwang sidebar, pagkatapos ayCreate, at piliin ang I am an Affiliate. Ang mga booking na iyong ipadala ay kikilalanin sa account na ito. Tingnan ang Create Account.
Step 2: Gumawa ng application
Section titled “Step 2: Gumawa ng application”Ang application ang nagbibigay ng kredensyal sa iyong code.
-
Sa iyong account card, i-click ang
Actions>Manage account, pagkatapos ay ang tab naApplications. -
I-click ang
Create new application, bigyan ito ng pangalan at piliin ang Machine-to-machine bilang client type. -
Sa ilalim ng scopes, piliin ang Inventory & rates (read). Tinitingnan ng Partner API ang
inventory.read. -
I-click ang
Create applicationat kopyahin ang Client ID at Client secret. Ang secret ay ipinapakita lamang isang beses at hindi na maaaring makuha muli.
Tingnan ang Applications para sa iba pang client types at scopes.
Step 3: Kumuha ng access token
Section titled “Step 3: Kumuha ng access token”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"I-save ang access_token mula sa tugon:
export WINK_TOKEN=<access_token>Ang mga token ay may expiration. Sa iyong sariling code, hayaang kumuha at mag-refresh ang isang OAuth2 library ng mga ito. Tingnan ang Authentication.
Kung tinanggihan ang kahilingan ng token, ang tugon ay isang JSON body na may error code:
error | HTTP status | Karaniwang sanhi |
|---|---|---|
invalid_client | 401 | Mali ang client ID o secret, o ginamit ang production credentials sa staging-iam |
invalid_scope | 400 | Humiling ng scope na hindi rehistrado sa application |
unauthorized_client | 400 | Hindi pinapayagan ang application na gamitin ang client_credentials grant |
invalid_request | 400 | May nawawalang kinakailangang parameter, halimbawa kapag JSON ang body sa halip na form |
Step 4: Hanapin ang iyong account ID
Section titled “Step 4: Hanapin ang iyong account ID”Bawat tawag sa Partner API ay nagsasaad ng account na iyong kinakatawan sa managing-entity-id header. Ilan ang mga account na maaaring gamitin ng iyong token:
grpcurl -H "authorization: Bearer $WINK_TOKEN" \ -d '{}' \ staging-partner.wink.travel:443 wink.partner.v1.Accounts/ListAccountsKopyahin ang accountId ng affiliate account mula sa Step 1:
export WINK_ACCOUNT_ID=<accountId>Step 5: Maghanap ng mga hotel sa isang lungsod
Section titled “Step 5: Maghanap ng mga hotel sa isang lungsod”May mga test hotel ang staging na may availability sa Bangkok, kaya ang paghahanap na ito ay gumagamit ng slug nito, 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/SearchByCityGumamit ng petsa ng check-in sa hinaharap; tinatanggihan ang mga nakaraang petsa. Bawat resulta ay may:
name,starRatingatheroImageUrl, sapat upang ipakita ang isang resulta sa listahan,roomTypes, ang mga live na alok, pinakamurang kuwarto muna,urlName, ang slug na kailangan mo para sa booking link.
Ang mga presyo ay mga integer sa minor units: hatiin sa 10 na may kapangyarihan ng currencyExponent mula sa tugon (2 para sa USD, kaya ang 12500 ay $125.00).
Hindi mo alam ang slug ng isang lungsod? I-resolve ito gamit ang wink.partner.v1.Lookup/Search. Para sa buong nilalaman ng isang property, gamitin ang Content service. Ang Partner API reference ay nagdodokumento ng bawat tawag.
Step 6: Bumuo ng booking link
Section titled “Step 6: Bumuo ng booking link”https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID>- Ang
<urlName>ay angurlNameng hotel mula sa Step 5. - Ang
client-iday ang Client ID ng iyong application mula sa Step 2. - Ang
configuration-iday ang iyong customization ID:Manage account>Customizations. Ang isang customization ay nagse-set din ng iyong branding, default na wika at pera sa pahina ng booking.
Ipadala ang paghahanap ng biyahero
Section titled “Ipadala ang paghahanap ng biyahero”Idagdag ang mga petsa, bisita, wika at pera ng biyahero sa parehong link upang magbukas ang pahina ng hotel na may mga ito nang naka-fill in:
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 | Kahulugan | Halimbawa |
|---|---|---|
sd | Petsa ng check-in | sd=2027-03-14 |
n o ed | Bilang ng gabi, o petsa ng check-out | n=2 o ed=2027-03-16 |
rc | Mga bisita bawat kuwarto | rc=a2 (2 matatanda) |
l | Wika ng pagpapakita | l=en |
c | Pera ng pagpapakita | c=USD |
p | Promotion code | p=ABC123 |
Pinapalitan ng mga parameter na ito ang mga default na itinakda sa iyong customization. Ang Book Now button guide ay sumasaklaw sa buong format ng rc, kabilang ang mga bata at ilang kuwarto.
Binubuksan ng link ang pahina ng hotel; hindi nito maaaring i-pre-select ang kuwarto o rate. Pinipili ng biyahero ang kuwarto sa pahina ng hotel, sa live na presyo.
Tingnan ang Linking directly para sa pag-link direkta sa home page ng booking engine sa halip na isang hotel lang.
Step 7: Gumawa ng test booking
Section titled “Step 7: Gumawa ng test booking”Buksan ang iyong link, pumili ng mga petsa at kuwarto, at mag-check out gamit ang isang Stripe test card, halimbawa 4242 4242 4242 4242 na may anumang hinaharap na expiry date at anumang CVC. Walang totoong card na sisingilin sa staging. Tandaan ang booking code sa pahina ng kumpirmasyon; nagsisimula ito sa WNK.
Step 8: Makakuha ng abiso tungkol sa mga booking
Section titled “Step 8: Makakuha ng abiso tungkol sa mga booking”-
Sa Portal, pumunta sa
Applications > Webhooksat magdagdag ng endpoint na tumatanggap ng mgaPOSTrequest. -
Mag-subscribe sa
booking.create, o iwanang walang laman ang listahan ng event upang makatanggap ng lahat habang ikaw ay nagde-develop. -
Magpadala ng test event sa iyong sarili, pagkatapos ay gumawa ng isa pang test booking at panoorin itong dumating.
Suriin ang lagda ng bawat delivery bago ito pagkatiwalaan. Tingnan ang Webhook Integration at ang Webhook Events Catalog.
Step 9: Lumipat sa production
Section titled “Step 9: Lumipat sa production”Walang hakbang ng pag-apruba para sa mga developer. (Ang mga account ng travel agency ay sertipikado muna; tingnan ang ibaba.) Kapag gumagana na ang iyong integrasyon sa staging:
-
Gumawa ng account at application sa app.wink.travel, tulad ng sa Steps 1 at 2. Hindi naililipat ang mga kredensyal sa pagitan ng mga environment.
-
Alisin ang
staging-mula sa bawat host:Staging Production https://staging-iam.wink.travelhttps://iam.wink.travelstaging-partner.wink.travel:443partner.wink.travel:443https://staging-book.wink.travelhttps://book.wink.travel -
Hanapin muli ang iyong production account ID (Step 4) at customization ID (Step 6). Iba ito sa staging.
Ang paggamit ng Partner API ay sinusukat sa hotel-nights, na may libreng buwanang allowance. Tingnan ang Partner API para sa pagpepresyo at mga limitasyon.
Booking bilang isang travel agency
Section titled “Booking bilang isang travel agency”Kung ang iyong account ay isang lisensyadong travel agency, hindi mo kailangang ipadala ang mga biyahero sa book.wink.travel: maaari kang gumawa ng mga booking nang direkta gamit ang wink.partner.v1.Booking/CreateBooking, at pamahalaan ang mga ito gamit ang iba pang tawag sa Booking. Ang ibang mga account ay nagpapadala ng mga biyahero sa booking link sa halip.
Ang mga account ng travel agency ay sertipikado: nire-review ng Wink ang bawat rehistrasyon ng ahensya bago ito makapag-book. Ang mga ahensya na nais kolektahin ang bayad mula sa kanilang mga kliyente bilang merchant of record ay dapat mag-book sa pamamagitan ng Partner API at makakuha ng nakasulat na pag-apruba mula sa Wink. Tingnan ang Getting Started as a Travel Agency at ang Partner API reference.
Mga susunod na hakbang
Section titled “Mga susunod na hakbang”- Gumawa ng typed client mula sa
.protoschema sa halip na tawagan anggrpcurlnang mano-mano. - Ikonekta ang MCP server at gamitin ang AI Skills upang ang iyong coding assistant ang sumulat ng integrasyon laban sa live API.
- Basahin ang buong listahan ng mga environment at host.
