Čtyři klíčové schopnosti
Sekce “Čtyři klíčové schopnosti”| Schopnost | Co znamená | Proč produkty bez ní stagnují |
|---|---|---|
| Aktuální ceny a dostupnost | Aktuální ceny a co je skutečně rezervovatelné, podle časového období | Uložené ceny selhávají při potvrzení a snižují důvěru |
| Vytvoření rezervace | Vytvořit skutečnou rezervaci, kterou hotel obdrží | Bez toho jste jen odkaz, ne produkt |
| Platba | Přijmout peníze jako součást rezervace | Přesměrování na jiný web zabíjí konverzi |
| Potvrzení a webhooks | Informovat hosta, hotel a váš systém, co se stalo | Jinak vznikají problémy s podporou a vyrovnáváním |
Většina „hotelových API“, která vývojář najde, pokrývá první a někdy druhou schopnost. Transakce je ta nejtěžší část a rozhoduje, zda máte produkt.
Čí nabídku integrujete?
Sekce “Čí nabídku integrujete?”Tato otázka ovlivňuje vše, co následuje. Nabídka prodávaná přes řetězec přichází s přirážkou v ceně, méně aktuální dostupností a bez možnosti zpětné komunikace s hotelem ohledně rezervace. Nabídka přímo od hotelu nese hotelovou vlastní cenu, aktuální dostupnost a hotel, který ví o existenci rezervace.
U všeho, kde cestovatel porovnává s webem hotelu — což je většina případů — hotelem řízená nabídka zabraňuje nepříjemnému momentu, kdy je vaše cena horší.
Kdo je obchodníkem záznamu
Sekce “Kdo je obchodníkem záznamu”Pokud si hotelové rezervace budujete sami, stát se obchodníkem záznamu znamená převzít odpovědnost za platby, reklamace, vrácení peněz, daňové záležitosti a často i cestovní agenturní licenci v každém trhu.
Na Wink hotel zůstává obchodníkem záznamu a platba je vybírána pro hotel, takže integrátor tuto zodpovědnost nepřebírá. Obchodnické uspořádání je dostupné u API integrací, kde partner skutečně potřebuje platbu přijímat sám, a tato cesta má vlastní licenční požadavky.
Tři úrovně integrace
Sekce “Tři úrovně integrace”- Webové komponenty. Vložte rezervovatelný vyhledávač, seznam pokojů nebo pokladnu do existující stránky. Žádná práce na backendu; nejmenší kontrola nad rozložením.
- REST API. Plná kontrola nad vyhledáváním, cenami, vytvářením rezervace a potvrzením, autentizace přes OAuth2. Použijte, když je rezervační proces součástí vašeho produktu.
- MCP server. Stejné schopnosti zpřístupněné AI agentům, aby asistent mohl vyhledávat, nacenit a dokončit rezervaci místo předání uživatele na web.
Tyto tři nejsou vzájemně výlučné — produkt běžně používá komponenty pro marketingovou část a API pro hlavní tok.
Co postavit nejdříve
Sekce “Co postavit nejdříve”- Vyhledávání a ceny pro jedno město a jedno časové období. Získejte skutečné ceny dříve, než začnete cokoliv navrhovat.
- Vytvořte jednu testovací rezervaci od začátku do konce, včetně platby a potvrzení.
- Přihlaste se k odběru
booking.createa událostí zrušení dříve, než začnete stavět UI. - Rozhodněte se brzy o modelu atribuce — kontext zdroje musí cestovat s rezervací, jinak je pozdější reportování jen odhad.
- Zvládněte chybové případy: ztráta dostupnosti mezi nabídkou a rezervací, zamítnutí platby, částečné refundace.
Ceny, které by měl vývojář znát
Sekce “Ceny, které by měl vývojář znát”Consumer a Booking Engine API jsou zdarma. Partner API obsahuje měsíční bezplatný limit 10 000 hotelových nocí, poté se účtuje za jednotku. Potvrzené rezervace nesou hotelovou platformní provizi 1,5 % plus náklady na zpracování karet a 10% výchozí provize platí, pokud vaši produkt přivedl rezervaci — což je způsob, jak integrátor vydělává, nikoliv platí.
Bezplatný limit je na jednoho integrátora. Otevírání více účtů za účelem obejití limitu je zneužití a vede k okamžitému trvalému zákazu. Viz Partner API usage and limits.
Časté chyby
Sekce “Časté chyby”- Stavět na uložených cenách. Vypadá to dobře při vývoji, ale selhává v produkci.
- Nechat platbu na přesměrování. Každé předání znamená ztrátu rezervací.
- Ignorovat webhooks až do spuštění. Vyrovnávání se stává ruční prací.
- Stát se obchodníkem záznamu bez potřeby. Je to rozhodnutí o licenci a odpovědnosti, ne jen technické.
- Nepředávat kontext zdroje. Atribuci nelze později rekonstruovat.