Pāriet uz saturu
Wink

Ātrā sākšana

Šis ceļvedis ved 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ēšanas 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ālūdz 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, tad 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

Kā tas darbojas

Section titled “Kā tas darbojas”

Tu izmanto Partner API, lai atrastu viesnīcas un to tiešās cenas. Katrai 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.

  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 sūti, tiek pieskaitītas šim kontam. Skatīt Izveidot kontu.

2. solis: Izveido lietotni

Section titled “2. solis: Izveido lietotni”

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. Izvēlies piekļuves tiesības (scopes) — Inventory & rates (lasīšana). Partner API pārbauda inventory.read.

  4. Klikšķini Create application un nokopē Client ID un Client secret. Slepenais atslēgas kods tiek rādīts tikai vienreiz un vēlāk to nevarēs iegūt.

Skatīt Lietotnes par citiem klientu tipiem un piekļuves tiesībām.

3. solis: Iegūsti piekļuves tokenu

Section titled “3. solis: Iegūsti piekļuves tokenu”
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. Savā kodā izmanto OAuth2 bibliotēku, lai tos iegūtu un atjaunotu. Skatīt Autentifikācija.

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, kuros 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>

5. solis: Meklē viesnīcas pilsētā

Section titled “5. solis: Meklē viesnīcas pilsētā”
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 tiks noraidīts. Katrs rezultāts satur:

  • name, starRating un heroImageUrl, pietiekami, lai parādītu rezultāta rindu,
  • roomTypes, tiešās cenas piedāvājumi, sākot ar lētāko numuru,
  • urlName, slugu, kas nepieciešams rezervēšanas 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. Lai iegūtu īpašuma pilnu saturu, izmanto Content servisu. Partner API atsauce dokumentē katru pieprasījumu.

6. solis: Izveido rezervēšanas saiti

Section titled “6. solis: Izveido rezervēšanas saiti”
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ēšanas lapā.

Skatīt Tieša saite par saites veidošanu uz rezervēšanas 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 veic norēķinu 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 maksa. 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 uzticies tam. Skatīt Webhook integrācija un Webhook notikumu katalogs.

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; skatīt 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 naktīs, ar bezmaksas mēneša limitu. Skatīt 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ēšanas 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. Skatīt Sākšana kā ceļojumu aģentūrai un Partner API atsauce.

Nākamie soļi

Section titled “Nākamie soļi”