Ātrā sākšana
Šis ceļvedis aizved tevi no nekā līdz darbīgai integrācijai aptuveni 30 minūtēs. Beigās tev būs:
- tiešās cenas viesnīcām pilsētā, no Partner API,
- rezervācijas saite, kas pieskaita rezervācijas tavā kontā,
- testa rezervācija un webhook, kas paziņo, ka tā notikusi.
Viss notiek staging vidē, mūsu testēšanas vidē. Tev nav jāprasa piekļuve, un pāreja uz ražošanu vēlāk neprasa apstiprinājumu.
Vai šis ceļvedis ir tev piemērots?
Section titled “Vai šis ceļvedis ir tev piemērots?”| Tu vēlies… | Sāc šeit |
|---|---|
| Rādīt viesnīcas savā lietotnē, vietnē vai AI produktā un nosūtīt ceļotājus rezervēt, pelnot komisiju | Šis ceļvedis |
| Rezervēt klientu vārdā kā licencēta ceļojumu aģentūra | Šis ceļvedis līdz 5. solim, pēc tam Rezervēšana kā ceļojumu aģentūra |
| Iegult rezervējamas viesnīcas bez integrācijas rakstīšanas | Web Components |
| Ļaut AI aģentam meklēt un rezervēt | MCP Servers un Agentic Payments |
| Pieslēgt kanālu pārvaldnieku vai PMS | Pievieno savu kanālu pārvaldnieku |
Kā tas darbojas
Section titled “Kā tas darbojas”Tu izmanto Partner API, lai atrastu viesnīcas un to tiešās cenas. Katram viesnīcai ir stabils urlName. Tu to pārvērš saitei uz Wink Booking Engine, book.wink.travel, kas nes tavus ID. Ceļotājs rezervē un maksā tur, un rezervācija tiek pieskaitīta tavā kontā.
Pirms sākt
Section titled “Pirms sākt”Tev būs nepieciešams:
grpcurl, vai Postman vai Insomnia. Partner API ir gRPC, nevis REST.curl.
1. solis: Izveido staging kontu
Section titled “1. solis: Izveido staging kontu”Staging ir pilnīgi atsevišķa no ražošanas vides, ar saviem pieteikšanās datiem un kontiem.
-
Dodies uz staging-app.wink.travel, klikšķini
Sign-In / Registerun reģistrējies. -
Kreisajā sānjoslā klikšķini
Accounts, tadCreate, un izvēlies I am an Affiliate. Rezervācijas, ko tu nosūti, tiek pieskaitītas šim kontam. Skati Create Account.
2. solis: Izveido lietotni
Section titled “2. solis: Izveido lietotni”Lietotne nodrošina tavam kodam akreditācijas datus.
-
Savā konta kartītē klikšķini
Actions>Manage account, tad cilniApplications. -
Klikšķini
Create new application, piešķir tai nosaukumu un izvēlies Machine-to-machine kā klienta tipu. -
Sadaļā scopes izvēlies Inventory & rates (lasīšana). Partner API pārbauda
inventory.read. -
Klikšķini
Create applicationun nokopē Client ID un Client secret. Noslēpums tiek parādīts tikai vienreiz un vēlāk to nevar iegūt.
Skati Applications par citiem klientu tipiem un scopes.
3. solis: Iegūsti piekļuves tokenu
Section titled “3. solis: Iegūsti piekļuves tokenu”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"Saglabā access_token no atbildes:
export WINK_TOKEN=<access_token>Tokeni beidzas derīguma termiņš. Savā kodā ļauj OAuth2 bibliotēkai tos iegūt un atjaunot. Skati Authentication.
Ja tokena pieprasījums tiek noraidīts, atbilde ir JSON ar error kodu:
error | HTTP statuss | Parastais iemesls |
|---|---|---|
invalid_client | 401 | Nepareizs klienta ID vai noslēpums, vai ražošanas akreditācijas dati izmantoti staging-iam |
invalid_scope | 400 | Pieprasīts scope, kuram lietotne nav reģistrēta |
unauthorized_client | 400 | Lietotnei nav atļauts izmantot client_credentials grant tipu |
invalid_request | 400 | Trūkst obligāts parametrs, piemēram, ķermenis ir JSON, nevis forma |
4. solis: Atrodi sava konta ID
Section titled “4. solis: Atrodi sava konta ID”Katrs Partner API pieprasījums norāda kontu, kura vārdā tu darbojies, ar managing-entity-id galveni. Uzskaiti kontus, kuru vārdā tavs tokens var darboties:
grpcurl -H "authorization: Bearer $WINK_TOKEN" \ -d '{}' \ staging-partner.wink.travel:443 wink.partner.v1.Accounts/ListAccountsNokopē 1. solī izveidotā affiliate konta accountId:
export WINK_ACCOUNT_ID=<accountId>5. solis: Meklē viesnīcas pilsētā
Section titled “5. solis: Meklē viesnīcas pilsētā”Staging vidē ir testa viesnīcas ar pieejamību Bangkokā, tāpēc šī meklēšana izmanto tā slugu 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/SearchByCityIzmanto nākotnes ierašanās datumu; pagātnes datums tiek noraidīts. Katrs rezultāts satur:
name,starRatingunheroImageUrl, pietiekami, lai parādītu rezultāta rindu,roomTypes, tiešās piedāvājums, sākot ar lētāko numuru,urlName, slugs, kas nepieciešams rezervācijas saitei.
Cenas ir veseli skaitļi mazākajās vienībās: daliet ar 10 pakāpi currencyExponent no atbildes (2 USD gadījumā, tāpēc 12500 ir $125.00).
Nezini pilsētas slugu? Atrodi to ar wink.partner.v1.Lookup/Search. Pilnu īpašuma saturu iegūsti ar Content servisu. Partner API atsauce dokumentē katru pieprasījumu.
6. solis: Izveido rezervācijas saiti
Section titled “6. solis: Izveido rezervācijas saiti”https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID><urlName>ir viesnīcasurlNameno 5. soļa.client-idir tava lietotnes Client ID no 2. soļa.configuration-idir tava pielāgošanas ID:Manage account>Customizations. Pielāgošana arī nosaka tavu zīmolu, noklusējuma valodu un valūtu rezervācijas lapā.
Pārsūti ceļotāja meklēšanas parametrus
Section titled “Pārsūti ceļotāja meklēšanas parametrus”Pievieno ceļotāja datumus, viesus, valodu un valūtu tai pašai saitei, lai viesnīcas lapa atvērtos ar aizpildītiem datiem:
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| Parametrs | Nozīme | Piemērs |
|---|---|---|
sd | Ierašanās datums | sd=2027-03-14 |
n vai ed | Nakšu skaits vai izrakstīšanās datums | n=2 vai ed=2027-03-16 |
rc | Viesu skaits numurā | rc=a2 (2 pieaugušie) |
l | Attēlošanas valoda | l=en |
c | Attēlošanas valūta | c=USD |
p | Akcijas kods | p=ABC123 |
Šie parametri aizstāj noklusējumus, kas iestatīti tavā pielāgojumā. Book Now pogas ceļvedis apraksta pilnu rc formātu, ieskaitot bērnus un vairākus numurus.
Saite atver viesnīcas lapu; tā nevar iepriekš izvēlēties numuru vai cenu. Ceļotājs izvēlas numuru viesnīcas lapā par tiešo cenu.
Skati Tieša saite, lai saiti novirzītu uz rezervācijas dzinēja sākumlapu, nevis uz vienu viesnīcu.
7. solis: Veic testa rezervāciju
Section titled “7. solis: Veic testa rezervāciju”Atver savu saiti, izvēlies datumus un numuru, un norēķinies ar Stripe testa karti, piemēram, 4242 4242 4242 4242 ar jebkuru nākotnes derīguma termiņu un jebkuru CVC. Staging vidē netiek iekasēta reāla karte. Piefiksē rezervācijas kodu apstiprinājuma lapā; tas sākas ar WNK.
8. solis: Saņem paziņojumus par rezervācijām
Section titled “8. solis: Saņem paziņojumus par rezervācijām”-
Portalā dodies uz
Applications > Webhooksun pievieno galapunktu, kas pieņemPOSTpieprasījumus. -
Abonē
booking.create, vai atstāj notikumu sarakstu tukšu, lai saņemtu visu attīstības laikā. -
Nosūti sev testa notikumu, tad veic vēl vienu testa rezervāciju un vēro, kā tas pienāk.
Pārbaudi katra piegādes parakstu pirms tam uzticoties. Skati Webhook integrācija un Webhook notikumu katalogu.
9. solis: Pārej uz ražošanu
Section titled “9. solis: Pārej uz ražošanu”Izstrādātājiem nav apstiprināšanas soļa. (Ceļojumu aģentūru konti tiek sertificēti vispirms; skati zemāk.) Kad tava integrācija darbojas staging vidē:
-
Izveido kontu un lietotni app.wink.travel, kā 1. un 2. solī. Akreditācijas dati netiek pārnesti starp vidēm.
-
Noņem
staging-no katra hosta:Staging Ražošana https://staging-iam.wink.travelhttps://iam.wink.travelstaging-partner.wink.travel:443partner.wink.travel:443https://staging-book.wink.travelhttps://book.wink.travel -
Atrodi savu ražošanas konta ID (4. solis) un pielāgošanas ID (6. solis) vēlreiz. Tie atšķiras no staging.
Partner API lietošana tiek mērīta viesnīcu-nakšu vienībās, ar bezmaksas mēneša limitu. Skati Partner API par cenām un ierobežojumiem.
Rezervēšana kā ceļojumu aģentūra
Section titled “Rezervēšana kā ceļojumu aģentūra”Ja tavs konts ir licencēta ceļojumu aģentūra, tev nav jānosūta ceļotāji uz book.wink.travel: tu vari veidot rezervācijas tieši ar wink.partner.v1.Booking/CreateBooking un pārvaldīt tās ar citiem Booking pieprasījumiem. Citi konti nosūta ceļotājus uz rezervācijas saiti.
Ceļojumu aģentūru konti tiek sertificēti: Wink pārskata katras aģentūras reģistrāciju pirms tā var rezervēt. Aģentūras, kas vēlas pašas iekasēt maksājumus no klientiem kā reģistrēts tirgotājs, ir jārezervē caur Partner API un jāsaņem Wink rakstiska atļauja. Skati Sākšana kā ceļojumu aģentūrai un Partner API atsauci.
Nākamie soļi
Section titled “Nākamie soļi”- Ģenerē tipizētu klientu no
.protoshēmas, nevis izmantogrpcurlmanuāli. - Pieslēdz MCP serveri un izmanto AI prasmes, lai tava kodēšanas asistents uzrakstītu integrāciju pret tiešo API.
- Izlasi pilnu vides un hostu sarakstu.
