Pāriet uz saturu

Ā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.

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īšanasWeb Components
Ļaut AI aģentam meklēt un rezervētMCP Servers un Agentic Payments
Pieslēgt kanālu pārvaldnieku vai PMSPievieno savu kanālu pārvaldnieku

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ā.

Tev būs nepieciešams:

  • grpcurl, vai Postman vai Insomnia. Partner API ir gRPC, nevis REST.
  • curl.

Staging ir pilnīgi atsevišķa no ražošanas vides, ar saviem pieteikšanās datiem un kontiem.

  1. Dodies uz staging-app.wink.travel, klikšķini Sign-In / Register un reģistrējies.

  2. Kreisajā sānjoslā klikšķini Accounts, tad Create, un izvēlies I am an Affiliate. Rezervācijas, ko tu nosūti, tiek pieskaitītas šim kontam. Skati Create Account.

Lietotne nodrošina tavam kodam akreditācijas datus.

  1. Savā konta kartītē klikšķini Actions > Manage account, tad cilni Applications.

  2. Klikšķini Create new application, piešķir tai nosaukumu un izvēlies Machine-to-machine kā klienta tipu.

  3. Sadaļā scopes izvēlies Inventory & rates (lasīšana). Partner API pārbauda inventory.read.

  4. Klikšķini Create application un 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.

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"

Saglabā access_token no atbildes:

Terminal window
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:

errorHTTP statussParastais iemesls
invalid_client401Nepareizs klienta ID vai noslēpums, vai ražošanas akreditācijas dati izmantoti staging-iam
invalid_scope400Pieprasīts scope, kuram lietotne nav reģistrēta
unauthorized_client400Lietotnei nav atļauts izmantot client_credentials grant tipu
invalid_request400Trūkst obligāts parametrs, piemēram, ķermenis ir JSON, nevis forma

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:

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

Nokopē 1. solī izveidotā affiliate konta accountId:

Terminal window
export WINK_ACCOUNT_ID=<accountId>

Staging vidē ir testa viesnīcas ar pieejamību Bangkokā, tāpēc šī meklēšana izmanto tā slugu 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

Izmanto nākotnes ierašanās datumu; pagātnes datums tiek noraidīts. Katrs rezultāts satur:

  • name, starRating un heroImageUrl, 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.

https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID>
  • <urlName> ir viesnīcas urlName no 5. soļa.
  • client-id ir tava lietotnes Client ID no 2. soļa.
  • configuration-id ir 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
ParametrsNozīmePiemērs
sdIerašanās datumssd=2027-03-14
n vai edNakšu skaits vai izrakstīšanās datumsn=2 vai ed=2027-03-16
rcViesu skaits numurārc=a2 (2 pieaugušie)
lAttēlošanas valodal=en
cAttēlošanas valūtac=USD
pAkcijas kodsp=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.

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”
  1. Portalā dodies uz Applications > Webhooks un pievieno galapunktu, kas pieņem POST pieprasījumus.

  2. Abonē booking.create, vai atstāj notikumu sarakstu tukšu, lai saņemtu visu attīstības laikā.

  3. 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.

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ē:

  1. Izveido kontu un lietotni app.wink.travel, kā 1. un 2. solī. Akreditācijas dati netiek pārnesti starp vidēm.

  2. Noņem staging- no katra hosta:

    StagingRažošana
    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. 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.

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.