Skip to content

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.

Želite…Začnite tukaj
Prikazovati hotele v vaši aplikaciji, spletnem mestu ali AI izdelku in poslati potnike k rezervaciji, da zaslužite provizijoTa vodič
Rezervirati v imenu svojih strank kot licencirana potovalna agencijaTa vodič do koraka 5, nato Rezervacija kot potovalna agencija
Vdelati rezervabilne hotele brez pisanja integracijeWeb Components
Dovoliti AI agentu, da išče in rezerviraMCP Servers in Agentic Payments
Povezati channel manager ali PMSDodajte svoj Channel Manager

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.

Potrebovali boste:

  • grpcurl, ali Postman ali Insomnia. Partner API je gRPC, ne REST.
  • curl.

Staging je popolnoma ločen od produkcije, z lastnimi prijavami in računi.

  1. Obiščite staging-app.wink.travel, kliknite Sign-In / Register in se registrirajte.

  2. Kliknite Accounts v levem stranskem meniju, nato Create in izberite I am an Affiliate. Rezervacije, ki jih pošljete, se pripišejo temu računu. Oglejte si Ustvarjanje računa.

Aplikacija vašemu kodi zagotovi poverilnice.

  1. Na kartici vašega računa kliknite Actions > Manage account, nato zavihek Applications.

  2. Kliknite Create new application, ji dajte ime in izberite Machine-to-machine kot tip odjemalca.

  3. Pod scopes izberite Inventory & rates (branje). Partner API preverja inventory.read.

  4. Kliknite Create application in 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.

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"

Shranjite access_token iz odgovora:

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

errorHTTP statusObičajen vzrok
invalid_client401Napačen Client ID ali skrivnost, ali so uporabljene produkcijske poverilnice na staging-iam
invalid_scope400Zahteva za scope, za katerega aplikacija ni registrirana
unauthorized_client400Aplikacija nima dovoljenja za uporabo client_credentials grant
invalid_request400Manjka zahtevan parameter, na primer ko je telo JSON namesto obrazec

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:

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

Kopirajte accountId partnerskega računa iz koraka 1:

Terminal window
export WINK_ACCOUNT_ID=<accountId>

Staging ima testne hotele z razpoložljivostjo v Bangkoku, zato ta iskanje uporablja njegov slug, 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

Uporabite prihodnji datum prijave; pretekli datum je zavrnjen. Vsak rezultat vsebuje:

  • name, starRating in heroImageUrl, 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> je urlName hotela iz koraka 5.
  • client-id je Client ID vaše aplikacije iz koraka 2.
  • configuration-id je ID vaše prilagoditve: Manage account > Customizations. Prilagoditev nastavi tudi vašo blagovno znamko, privzeti jezik in valuto na strani za rezervacijo.

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
ParameterPomenPrimer
sdDatum prijavesd=2027-03-14
n ali edŠtevilo noči ali datum odjaven=2 ali ed=2027-03-16
rcGostje na soborc=a2 (2 odrasla)
lPrikazni jezikl=en
cPrikazna valutac=USD
pPromocijska kodap=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.

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”
  1. V Portalu pojdite na Applications > Webhooks in dodajte končno točko, ki sprejema POST zahteve.

  2. Naročite se na booking.create, ali pustite seznam dogodkov prazen, da med razvojem prejmete vse.

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

Za razvijalce ni koraka odobritve. (Računi potovalnih agencij so najprej certificirani; glejte spodaj.) Ko vaša integracija deluje v stagingu:

  1. Ustvarite račun in aplikacijo na app.wink.travel, kot v korakih 1 in 2. Poverilnice se ne prenašajo med okolji.

  2. Odstranite staging- iz vseh gostiteljev:

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

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