Přeskočit na obsah

Rychlý start

Tento průvodce vás provede od začátku k funkční integraci přibližně za 30 minut. Na konci budete mít:

  • živé ceny hotelů ve městě z Partner API,
  • rezervační odkaz, který přičítá rezervace na váš účet,
  • testovací rezervaci a webhook, který vás o ní informuje.

Vše probíhá v stagingu, našem testovacím prostředí. Nemusíte nás žádat o přístup a přechod do produkce později také nepotřebuje schválení.

Je tento průvodce pro vás ten pravý?

Sekce “Je tento průvodce pro vás ten pravý?”
Chcete…Začněte zde
Zobrazovat hotely ve své aplikaci, na webu nebo v AI produktu a posílat cestovatele k rezervaci, za kterou získáte proviziTento průvodce
Rezervovat jménem svých klientů jako licencovaná cestovní kancelářTento průvodce do kroku 5, pak Rezervace jako cestovní kancelář
Vložit rezervovatelné hotely bez psaní integraceWeb Components
Nechat AI agenta vyhledávat a rezervovatMCP Servers a Agentic Payments
Připojit channel manager nebo PMSPřidat svůj channel manager

Používáte Partner API k nalezení hotelů a jejich živých cen. Každý hotel má stabilní urlName. Ten přeměníte na odkaz na Wink Booking Engine, book.wink.travel, který nese vaše ID. Cestovatel zde rezervuje a platí a rezervace je přičtena na váš účet.

Budete potřebovat:

  • grpcurl, nebo Postman či Insomnia. Partner API je gRPC, ne REST.
  • curl.

Krok 1: Vytvořte staging účet

Sekce “Krok 1: Vytvořte staging účet”

Staging je zcela oddělený od produkce, má vlastní přihlašovací údaje a účty.

  1. Přejděte na staging-app.wink.travel, klikněte na Sign-In / Register a zaregistrujte se.

  2. Klikněte na Accounts v levém panelu, pak na Create a vyberte I am an Affiliate. Rezervace, které odešlete, se přičítají na tento účet. Viz Vytvoření účtu.

Krok 2: Vytvořte aplikaci

Sekce “Krok 2: Vytvořte aplikaci”

Aplikace poskytne vašemu kódu přihlašovací údaje.

  1. Na kartě svého účtu klikněte na Actions > Manage account, pak na záložku Applications.

  2. Klikněte na Create new application, pojmenujte ji a vyberte Machine-to-machine jako typ klienta.

  3. V sekci scopes vyberte Inventory & rates (read). Partner API kontroluje inventory.read.

  4. Klikněte na Create application a zkopírujte Client ID a Client secret. Tajný klíč je zobrazen pouze jednou a později ho nelze získat.

Viz Applications pro další typy klientů a scopes.

Krok 3: Získejte přístupový token

Sekce “Krok 3: Získejte přístupový token”
Terminál
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 access_token z odpovědi:

Terminál
export WINK_TOKEN=<access_token>

Tokeny expirují. Ve vlastním kódu nechte OAuth2 knihovnu tokeny získávat a obnovovat. Viz Autentizace.

Pokud je požadavek na token odmítnut, odpověď obsahuje JSON s kódem error:

errorHTTP statusObvyklá příčina
invalid_client401Špatné client ID nebo secret, nebo použití produkčních údajů na staging-iam
invalid_scope400Požadavek obsahuje scope, na který aplikace není registrována
unauthorized_client400Aplikace nesmí používat grant client_credentials
invalid_request400Chybí povinný parametr, například tělo je JSON místo formuláře

Krok 4: Najděte své ID účtu

Sekce “Krok 4: Najděte své ID účtu”

Každé volání Partner API uvádí účet, za který jednáte, v hlavičce managing-entity-id. Vylistujte účty, za které může váš token jednat:

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

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

Terminál
export WINK_ACCOUNT_ID=<accountId>

Krok 5: Vyhledejte hotely ve městě

Sekce “Krok 5: Vyhledejte hotely ve městě”

Staging má testovací hotely s dostupností v Bangkoku, proto tento dotaz používá jeho slug bangkok-thailand:

Terminál
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žijte datum příjezdu v budoucnosti; datum v minulosti je odmítnuto. Každý výsledek obsahuje:

  • name, starRating a heroImageUrl, dost pro zobrazení řádku výsledku,
  • roomTypes, živé nabídky, nejlevnější pokoj první,
  • urlName, slug potřebný pro rezervační odkaz.

Ceny jsou celá čísla v menších jednotkách: vydělte je 10 na mocninu currencyExponent z odpovědi (2 pro USD, takže 12500 je 125,00 $).

Neznáte slug města? Vyhledejte ho pomocí wink.partner.v1.Lookup/Search. Pro plný obsah objektu použijte službu Content. Partner API reference dokumentuje všechny volání.

Krok 6: Sestavte rezervační odkaz

Sekce “Krok 6: Sestavte rezervační odkaz”
https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID>
  • <urlName> je urlName hotelu z kroku 5.
  • client-id je Client ID vaší aplikace z kroku 2.
  • configuration-id je vaše ID přizpůsobení: Manage account > Customizations. Přizpůsobení také nastavuje vaši značku, výchozí jazyk a měnu na rezervační stránce.

Předat vyhledávání cestovatele

Sekce “Předat vyhledávání cestovatele”

Přidejte cestovatelovy datumy, počet hostů, jazyk a měnu do stejného odkazu, aby se stránka hotelu otevřela s vyplněnými údaji:

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
ParametrVýznamPříklad
sdDatum příjezdusd=2027-03-14
n nebo edPočet nocí nebo datum odjezdun=2 nebo ed=2027-03-16
rcHosté na pokojrc=a2 (2 dospělí)
lJazyk zobrazeníl=en
cMěna zobrazeníc=USD
pPromo kódp=ABC123

Tyto parametry přepisují výchozí hodnoty nastavené ve vašem přizpůsobení. Kompletní formát rc, včetně dětí a více pokojů, najdete v průvodci tlačítkem Book Now.

Odkaz otevře stránku hotelu; nelze předvybrat pokoj nebo sazbu. Cestovatel si pokoj vybere na stránce hotelu za živou cenu.

Viz Přímé odkazování pro odkazování na domovskou stránku rezervačního enginu místo na jeden hotel.

Krok 7: Proveďte testovací rezervaci

Sekce “Krok 7: Proveďte testovací rezervaci”

Otevřete svůj odkaz, vyberte datumy a pokoj a zaplaťte pomocí testovací karty Stripe, například 4242 4242 4242 4242 s libovolným budoucím datem expirace a libovolným CVC. Ve stagingu se žádná skutečná karta neúčtuje. Poznamenejte si kód rezervace na potvrzovací stránce; začíná na WNK.

Krok 8: Nechte se upozornit na rezervace

Sekce “Krok 8: Nechte se upozornit na rezervace”
  1. V Portálu přejděte na Applications > Webhooks a přidejte endpoint, který přijímá požadavky POST.

  2. Přihlaste se k odběru booking.create, nebo nechte seznam událostí prázdný, abyste během vývoje dostávali vše.

  3. Pošlete si testovací událost, pak proveďte další testovací rezervaci a sledujte její doručení.

Před důvěrou ověřte podpis každého doručení. Viz Webhook Integration a Katalog webhook událostí.

Krok 9: Přechod do produkce

Sekce “Krok 9: Přechod do produkce”

Pro vývojáře není potřeba schválení. (Účty cestovních kanceláří jsou nejprve certifikovány; viz níže.) Když vaše integrace funguje ve stagingu:

  1. Vytvořte účet a aplikaci na app.wink.travel, jako v krocích 1 a 2. Přihlašovací údaje se mezi prostředími nepřenášejí.

  2. Odstraňte staging- z každého hostitele:

    StagingProdukce
    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 vyhledejte své produkční ID účtu (krok 4) a ID přizpůsobení (krok 6). Liší se od stagingu.

Používání Partner API se měří v hotelových nocích, s měsíční bezplatnou kvótou. Viz Partner API pro ceny a limity.

Rezervace jako cestovní kancelář

Sekce “Rezervace jako cestovní kancelář”

Pokud máte účet licencované cestovní kanceláře, nemusíte posílat cestovatele na book.wink.travel: můžete vytvářet rezervace přímo pomocí wink.partner.v1.Booking/CreateBooking a spravovat je dalšími voláními Booking. Ostatní účty posílají cestovatele na rezervační odkaz.

Účty cestovních kanceláří jsou certifikovány: Wink kontroluje registraci každé kanceláře před tím, než může rezervovat. Kanceláře, které chtějí vybírat platby od svých klientů samy jako obchodník, musí rezervovat přes Partner API a získat písemné schválení od Wink. Viz Začínáme jako cestovní kancelář a Partner API reference.