Skip to content
Wink

Hitri začetek

Ta vodič vas v približno 30 minutah popelje od nič do delujoče integracije. Na koncu boste imeli:

  • aktualne 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 o njej.

Vse se dogaja v staging okolju, našem testnem okolju. Ni vam treba prositi za dostop, prav tako za prehod v produkcijo kasneje ni potrebnega odobritve.

Je ta vodič pravi za vas?

Section titled “Je ta vodič pravi za vas?”
Želite…Začnite tukaj
Prikazovati hotele v vaši aplikaciji, spletni strani ali AI produktu in poslati popotnike 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

Kako deluje

Section titled “Kako deluje”

Uporabite Partner API za iskanje hotelov in njihovih aktualnih cen. Vsak hotel ima stabilen urlName. To spremenite v povezavo do Wink Booking Engine, book.wink.travel, ki nosi vaše ID-je. Popotnik rezervira in plača tam, rezervacija pa se pripiše vašemu računu.

Preden začnete

Section titled “Preden začnete”

Potrebovali boste:

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

Korak 1: Ustvarite staging račun

Section titled “Korak 1: Ustvarite staging račun”

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.

Korak 2: Ustvarite aplikacijo

Section titled “Korak 2: Ustvarite aplikacijo”

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, poimenujte jo in izberite Machine-to-machine kot tip odjemalca.

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

  4. Kliknite Create application in kopirajte Client ID in Client secret. Geslo je prikazano samo enkrat in ga kasneje ni mogoče pridobiti.

Oglejte si Applications za druge tipe odjemalcev in scope.

Korak 3: Pridobite dostopni žeton

Section titled “Korak 3: Pridobite dostopni žeton”
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 Avtentikacija.

Korak 4: Poiščite ID vašega računa

Section titled “Korak 4: Poiščite ID vašega računa”

Vsak klic Partner API-ja navede račun, za katerega delujete, v glavi managing-entity-id. Naštejte račune, za katere lahko vaš žeton deluje:

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

Kopirajte accountId affiliate računa iz koraka 1:

Terminal window
export WINK_ACCOUNT_ID=<accountId>

Korak 5: Poiščite hotele v mestu

Section titled “Korak 5: Poiščite hotele v mestu”
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, aktualne 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 12500 pomeni 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.

Oglejte si Neposredno povezovanje za povezavo do domače strani rezervacijskega sistema namesto do posameznega hotela.

Korak 7: Naredite testno rezervacijo

Section titled “Korak 7: Naredite testno rezervacijo”

Odprite svojo povezavo, izberite datume in sobo ter zaključite z Stripe testno kartico, na primer 4242 4242 4242 4242 z poljubnim prihodnjim datumom poteka in poljubnim CVC. V staging okolju 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 opazujte, kako prispe.

Pred zaupanjem preverite podpis vsake dostave. Oglejte si Integracija webhookov in Katalog webhook dogodkov.

Korak 9: Pojdite v produkcijo

Section titled “Korak 9: Pojdite v produkcijo”

Za razvijalce ni potrebnega 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 ID produkcijskega 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.

Rezervacija kot potovalna agencija

Section titled “Rezervacija kot potovalna agencija”

Če je vaš račun licencirana potovalna agencija, ni treba pošiljati popotnikov na book.wink.travel: rezervacije lahko ustvarjate neposredno z wink.partner.v1.Booking/CreateBooking in jih upravljate z ostalimi klici Booking. Drugi računi pošiljajo popotnike 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 preko Partner API-ja in pridobiti pisno odobritev Wink. Oglejte si Začetek kot potovalna agencija in Partner API referenco.

Naslednji koraki

Section titled “Naslednji koraki”