Preskočiť na obsah

Rýchly štart

Tento návod vás prevedie od úplného začiatku k fungujúcej integrácii približne za 30 minút. Na konci budete mať:

  • aktuálne ceny hotelov v meste z Partner API,
  • rezervačný odkaz, ktorý pripisuje rezervácie na váš účet,
  • testovaciu rezerváciu a webhook, ktorý vás o nej informuje.

Všetko prebieha v stagingu, našom testovacom prostredí. Nemusíte nás žiadať o prístup a prechod do produkcie neskôr nevyžaduje schválenie.

Chcete…Začať tu
Zobraziť hotely vo vašej aplikácii, na webe alebo v AI produkte a poslať cestujúcich na rezerváciu, pričom získate províziuTento návod
Rezervovať v mene svojich klientov ako licencovaná cestovná kanceláriaTento návod do kroku 5, potom Rezervovanie ako cestovná kancelária
Vložiť rezervovateľné hotely bez písania integrácieWeb Components
Nechať AI agenta vyhľadávať a rezervovaťMCP Servers a Agentic Payments
Pripojiť channel manager alebo PMSPridať svoj channel manager

Používate Partner API na vyhľadávanie hotelov a ich aktuálnych cien. Každý hotel má stabilný urlName. Ten premeníte na odkaz do Wink Booking Engine, book.wink.travel, ktorý nesie vaše ID. Cestujúci tam rezervuje a platí a rezervácia sa pripíše na váš účet.

Budete potrebovať:

  • grpcurl, alebo Postman či Insomnia. Partner API je gRPC, nie REST.
  • curl.

Staging je úplne oddelený od produkcie, má vlastné prihlasovacie údaje a účty.

  1. Choďte na staging-app.wink.travel, kliknite na Sign-In / Register a zaregistrujte sa.

  2. Kliknite na Accounts v ľavom bočnom paneli, potom na Create a vyberte I am an Affiliate. Rezervácie, ktoré odošlete, sa pripíšu na tento účet. Viď Vytvorenie účtu.

Aplikácia poskytne vášmu kódu prihlasovacie údaje.

  1. Na karte vášho účtu kliknite na Actions > Manage account, potom na záložku Applications.

  2. Kliknite na Create new application, pomenujte ju a vyberte Machine-to-machine ako typ klienta.

  3. V sekcii scopes vyberte Inventory & rates (read). Partner API vyžaduje inventory.read.

  4. Kliknite na Create application a skopírujte Client ID a Client secret. Tajný kľúč sa zobrazí iba raz a neskôr ho nemožno získať späť.

Viac o typoch klientov a scopes nájdete v Applications.

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"

Uložte si access_token z odpovede:

Terminal window
export WINK_TOKEN=<access_token>

Tokeny majú platnosť. Vo vlastnom kóde používajte OAuth2 knižnicu na ich získavanie a obnovovanie. Viď Autentifikácia.

Ak je žiadosť o token odmietnutá, odpoveď obsahuje JSON s kódom error:

errorHTTP stavBežná príčina
invalid_client401Nesprávne client ID alebo secret, alebo použité produkčné údaje na staging-iam
invalid_scope400Žiadosť obsahuje scope, na ktorý aplikácia nie je registrovaná
unauthorized_client400Aplikácia nemá povolenie používať grant client_credentials
invalid_request400Chýba povinný parameter, napríklad keď je telo JSON namiesto formulára

Každý Partner API volanie uvádza účet, za ktorý konáte, v hlavičke managing-entity-id. Zobrazte si účty, za ktoré môže váš token konať:

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

Skopírujte accountId affiliate účtu z kroku 1:

Terminal window
export WINK_ACCOUNT_ID=<accountId>

Staging má testovacie hotely s dostupnosťou v Bangkoku, preto tento príklad používa jeho 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

Použite dátum príchodu v budúcnosti; dátum v minulosti je odmietnutý. Každý výsledok obsahuje:

  • name, starRating a heroImageUrl, dosť na zobrazenie riadku výsledku,
  • roomTypes, aktuálne ponuky, najlacnejšia izba ako prvá,
  • urlName, slug potrebný pre rezervačný odkaz.

Ceny sú celé čísla v menších jednotkách: vydelte ich 10 na mocninu currencyExponent z odpovede (2 pre USD, takže 12500 je 125,00 $).

Neviete slug mesta? Zistite ho pomocou wink.partner.v1.Lookup/Search. Pre kompletný obsah objektu použite službu Content. Kompletnú dokumentáciu nájdete v Partner API reference.

https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID>
  • <urlName> je urlName hotela z kroku 5.
  • client-id je Client ID vašej aplikácie z kroku 2.
  • configuration-id je ID vašej customizácie: Manage account > Customizations. Customizácia nastavuje aj vašu značku, predvolený jazyk a menu na rezervačnej stránke.

Pridajte do odkazu dátumy, hostí, jazyk a menu cestujúceho, aby sa stránka hotela otvorila s vyplnenými údajmi:

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
ParameterVýznamPríklad
sdDátum príchodusd=2027-03-14
n alebo edPočet nocí alebo dátum odchodun=2 alebo ed=2027-03-16
rcHostia na izburc=a2 (2 dospelí)
lJazyk zobrazenial=en
cMena zobrazeniac=USD
pPromo kódp=ABC123

Tieto parametre prepíšu predvolené nastavenia vašej customizácie. Kompletný formát rc, vrátane detí a viacerých izieb, nájdete v návode na tlačidlo Book Now.

Odkaz otvorí stránku hotela; izbu alebo cenu nie je možné predvybrať. Cestujúci si izbu vyberie na stránke hotela za aktuálnu cenu.

Viď Priame prepojenie pre prepojenie na domovskú stránku rezervačného systému namiesto konkrétneho hotela.

Otvorte svoj odkaz, vyberte dátumy a izbu a zaplaťte pomocou testovacej karty Stripe, napríklad 4242 4242 4242 4242 s ľubovoľným budúcim dátumom platnosti a ľubovoľným CVC. V stagingu sa neúčtuje žiadna skutočná karta. Zapíšte si kód rezervácie na potvrdení; začína na WNK.

Krok 8: Dostaňte notifikácie o rezerváciách

Section titled “Krok 8: Dostaňte notifikácie o rezerváciách”
  1. V Portáli choďte na Applications > Webhooks a pridajte endpoint, ktorý prijíma POST požiadavky.

  2. Prihláste sa na odber udalosti booking.create, alebo nechajte zoznam udalostí prázdny, aby ste dostávali všetko počas vývoja.

  3. Pošlite si testovaciu udalosť, potom vykonajte ďalšiu testovaciu rezerváciu a sledujte jej doručenie.

Pred dôverou overte podpis každej doručenej správy. Viď Webhook Integration a Katalóg webhook udalostí.

Pre vývojárov nie je potrebný žiadny schvaľovací krok. (Účty cestovných kancelárií sú najprv certifikované; viď nižšie.) Keď vaša integrácia funguje v stagingu:

  1. Vytvorte si účet a aplikáciu na app.wink.travel, ako v krokoch 1 a 2. Prihlasovacie údaje sa medzi prostrediami neprenášajú.

  2. Odstráňte staging- z každého hostiteľa:

    StagingProdukcia
    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. Znovu si vyhľadajte ID produkčného účtu (Krok 4) a ID customizácie (Krok 6). Líšia sa od stagingu.

Používanie Partner API sa meria v hotelových nociach, s mesačnou bezplatnou kvótou. Viď Partner API pre ceny a limity.

Ak máte účet licencovanej cestovnej kancelárie, nemusíte posielať cestujúcich na book.wink.travel: môžete vytvárať rezervácie priamo cez wink.partner.v1.Booking/CreateBooking a spravovať ich ďalšími volaniami Booking. Ostatné účty posielajú cestujúcich na rezervačný odkaz.

Účty cestovných kancelárií sú certifikované: Wink preveruje registráciu každej kancelárie pred povolením rezervácií. Kancelárie, ktoré chcú prijímať platby od svojich klientov samy ako merchant of record, musia rezervovať cez Partner API a získať písomné schválenie od Wink. Viď Začíname ako cestovná kancelária a Partner API reference.