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.
Je tento návod pre vás ten pravý?
Section titled “Je tento návod pre vás ten pravý?”| 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íziu | Tento návod |
| Rezervovať v mene svojich klientov ako licencovaná cestovná kancelária | Tento návod do kroku 5, potom Rezervovanie ako cestovná kancelária |
| Vložiť rezervovateľné hotely bez písania integrácie | Web Components |
| Nechať AI agenta vyhľadávať a rezervovať | MCP Servers a Agentic Payments |
| Pripojiť channel manager alebo PMS | Pridať svoj channel manager |
Ako to funguje
Section titled “Ako to funguje”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.
Pred začiatkom
Section titled “Pred začiatkom”Budete potrebovať:
grpcurl, alebo Postman či Insomnia. Partner API je gRPC, nie REST.curl.
Krok 1: Vytvorte si staging účet
Section titled “Krok 1: Vytvorte si staging účet”Staging je úplne oddelený od produkcie, má vlastné prihlasovacie údaje a účty.
-
Choďte na staging-app.wink.travel, kliknite na
Sign-In / Registera zaregistrujte sa. -
Kliknite na
Accountsv ľavom bočnom paneli, potom naCreatea vyberte I am an Affiliate. Rezervácie, ktoré odošlete, sa pripíšu na tento účet. Viď Vytvorenie účtu.
Krok 2: Vytvorte aplikáciu
Section titled “Krok 2: Vytvorte aplikáciu”Aplikácia poskytne vášmu kódu prihlasovacie údaje.
-
Na karte vášho účtu kliknite na
Actions>Manage account, potom na záložkuApplications. -
Kliknite na
Create new application, pomenujte ju a vyberte Machine-to-machine ako typ klienta. -
V sekcii scopes vyberte Inventory & rates (read). Partner API vyžaduje
inventory.read. -
Kliknite na
Create applicationa 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.
Krok 3: Získajte prístupový token
Section titled “Krok 3: Získajte prístupový token”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:
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:
error | HTTP stav | Bežná príčina |
|---|---|---|
invalid_client | 401 | Nesprávne client ID alebo secret, alebo použité produkčné údaje na staging-iam |
invalid_scope | 400 | Žiadosť obsahuje scope, na ktorý aplikácia nie je registrovaná |
unauthorized_client | 400 | Aplikácia nemá povolenie používať grant client_credentials |
invalid_request | 400 | Chýba povinný parameter, napríklad keď je telo JSON namiesto formulára |
Krok 4: Nájdite ID svojho účtu
Section titled “Krok 4: Nájdite ID svojho účtu”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ť:
grpcurl -H "authorization: Bearer $WINK_TOKEN" \ -d '{}' \ staging-partner.wink.travel:443 wink.partner.v1.Accounts/ListAccountsSkopírujte accountId affiliate účtu z kroku 1:
export WINK_ACCOUNT_ID=<accountId>Krok 5: Vyhľadajte hotely v meste
Section titled “Krok 5: Vyhľadajte hotely v meste”Staging má testovacie hotely s dostupnosťou v Bangkoku, preto tento príklad používa jeho slug bangkok-thailand:
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/SearchByCityPoužite dátum príchodu v budúcnosti; dátum v minulosti je odmietnutý. Každý výsledok obsahuje:
name,starRatingaheroImageUrl, 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.
Krok 6: Vytvorte rezervačný odkaz
Section titled “Krok 6: Vytvorte rezervačný odkaz”https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID><urlName>jeurlNamehotela z kroku 5.client-idje Client ID vašej aplikácie z kroku 2.configuration-idje 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.
Preneste vyhľadávanie cestujúceho
Section titled “Preneste vyhľadávanie cestujúceho”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| Parameter | Význam | Príklad |
|---|---|---|
sd | Dátum príchodu | sd=2027-03-14 |
n alebo ed | Počet nocí alebo dátum odchodu | n=2 alebo ed=2027-03-16 |
rc | Hostia na izbu | rc=a2 (2 dospelí) |
l | Jazyk zobrazenia | l=en |
c | Mena zobrazenia | c=USD |
p | Promo kód | p=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.
Krok 7: Vykonajte testovaciu rezerváciu
Section titled “Krok 7: Vykonajte testovaciu rezerváciu”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”-
V Portáli choďte na
Applications > Webhooksa pridajte endpoint, ktorý prijímaPOSTpožiadavky. -
Prihláste sa na odber udalosti
booking.create, alebo nechajte zoznam udalostí prázdny, aby ste dostávali všetko počas vývoja. -
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í.
Krok 9: Prejdite do produkcie
Section titled “Krok 9: Prejdite do produkcie”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:
-
Vytvorte si účet a aplikáciu na app.wink.travel, ako v krokoch 1 a 2. Prihlasovacie údaje sa medzi prostrediami neprenášajú.
-
Odstráňte
staging-z každého hostiteľa:Staging Produkcia https://staging-iam.wink.travelhttps://iam.wink.travelstaging-partner.wink.travel:443partner.wink.travel:443https://staging-book.wink.travelhttps://book.wink.travel -
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.
Rezervovanie ako cestovná kancelária
Section titled “Rezervovanie ako cestovná kancelária”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.
Ďalšie kroky
Section titled “Ďalšie kroky”- Vygenerujte typizovaného klienta zo schémy
.protonamiesto ručného volaniagrpcurl. - Pripojte MCP server a použite AI Skills, aby vám váš kódovací asistent napísal integráciu proti živému API.
- Prečítajte si kompletný zoznam prostredí a hostiteľov.
