Preskočiť na obsah
Wink

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 si u nás žiadať 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 posielať 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 PMSPridajte 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.

  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é pošlete, sa pripíšu na tento účet. Viac na Create Account.

Krok 2: Vytvorte aplikáciu

Section titled “Krok 2: Vytvorte aplikáciu”

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

  1. Na karte svojho úč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 scope vyberte Inventory & rates (read). Partner API vyžaduje inventory.read.

  4. Kliknite na Create application a skopírujte Client ID a Client secret. Secret sa zobrazí iba raz a neskôr ho nemožno získať.

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

Krok 3: Získajte prístupový token

Section titled “Krok 3: Získajte prístupový token”
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. Viac na Authentication.

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ť:

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>

Krok 5: Vyhľadajte hotely v meste

Section titled “Krok 5: Vyhľadajte hotely v meste”
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 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. Partner API referencia dokumentuje všetky volania.

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> 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še branding, predvolený jazyk a menu na rezervačnej stránke.

Viac o priamej linke nájdete v Linking directly, ak chcete odkazovať na domovskú stránku rezervačného systému namiesto jedného 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 expirácie a ľubovoľným CVC. V stagingu sa neúčtuje žiadna skutočná karta. Poznačte si rezervačný kód 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 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 urobte ďalšiu testovaciu rezerváciu a sledujte jej doručenie.

Pred dôverou overte podpis každej doručenej správy. Viac na Webhook Integration a v Webhook Events Catalog.

Krok 9: Prejdite do produkcie

Section titled “Krok 9: Prejdite do produkcie”

Pre vývojárov nie je potrebné schválenie. (Úč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. Viac o cenách a limitoch na Partner API.

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 predtým, než môže rezervovať. Kancelárie, ktoré chcú vyberať platby priamo od svojich klientov ako merchant of record, musia rezervovať cez Partner API a získať písomné schválenie od Wink. Viac na Začíname ako cestovná kancelária a v Partner API referencii.

Ďalšie kroky

Section titled “Ďalšie kroky”