在您的產品中建構酒店商務。
Section titled “在您的產品中建構酒店商務。”API 優先的酒店商務：搜尋、訂房、付款、70 個 Webhook、歸因與 AI 交接 — 搭配託管的 MCP 伺服器讓代理讀取即時合約，底層由 Booking Engine 履約。
# 1 · connect an agent or coding client
$ claude mcp add wink
https://api.wink.travel/mcp --transport http
→ browser sign-in at iam.wink.travel
✓ connected · OAuth2 + PKCE · no client secret
# 2 · find the operation, read the live contract
api_search "create booking"
→ POST /bookings · wink://api/operation/createBooking
# 3 · create the booking, take payment
$ wink bookings create --rate rp_8421
201 · #WK-2X9F · paid via Wink
# 4 · react in real time
on booking.create → fulfill & reconcile
開發者能用 Wink 建構什麼？
開發者可以將酒店搜尋、訂房、付款、Webhook、歸因、報告、AI 交接及嵌入式商務工作流程建構到自己的產品中。Wink 開發者存取支援來自 Extranet 的酒店控管供應、底層網絡的合作夥伴上下文、透過 Agentic AI 的 AI 交接，以及 Booking Engine 履約酒店專屬的結帳、付款、確認和訂房完成。
適用對象
給建構酒店商務的團隊，而不只是閱讀文件。
Section titled “給建構酒店商務的團隊，而不只是閱讀文件。”開發者存取適合產品、工程、AI、平台及營運團隊。正在評估 AI 產品、銀行或超級應用的整合？請參考 給平台與 AI。
產品團隊
透過開發者存取 + Booking Engine，為現有應用或平台新增酒店商務。
AI 產品團隊
利用 Agentic AI 與 MCP 伺服器，將助理引導的酒店意圖導入受控訂房流程。
代理商與 DMC
使用 Web Components 建構自訂商店、訂房流程或行程產品。
渠道管理者 / PMS
協調可用性、價格、訂房及相關事件流程。
為什麼要建構在它上面
酒店卡片很簡單，酒店訂房系統卻不然。
Section titled “酒店卡片很簡單，酒店訂房系統卻不然。”酒店商務需要供應規則、可用性、價格、優惠、政策、結帳、付款、確認、歸因與報告。建構在這些層次上，而非重新打造它們。
- 重建供應、價格與政策規則
- 將結帳串接至酒店專屬資料
- 跨會話串接歸因
- 管理付款、退款與對帳
- 設置 AI 防護，避免虛構可用性
- 隨著酒店每日變動持續維護
建構於 Wink
Section titled “建構於 Wink”- 整合來自 Extranet 的酒店核准供應
- Booking Engine 處理結帳、付款與確認
- 每次點擊保留 6 個月歸因
- 訂閱 70 個 Webhook 事件
- 透過 MCP + Agentic AI 進行結構化 AI 交接
- 1.5% + 成本處理費 — 每次交接底層皆由 Booking Engine 履約
- 1
連接
新增託管 MCP 伺服器或建立 OAuth2 憑證，開始對即時合約進行操作。
- 2
讀取即時合約
搜尋操作並讀取當前請求與回應結構 — 無需猜測，無過時文件。
- 3
建構流程
將搜尋、可用性、訂房、付款與報告串接到您的產品中。
- 4
訂閱事件
對 70 個 Webhook 事件做出反應：訂房狀態、付款、退款、取消與渠道變更。
- 5
由 Booking Engine 履約
每次呼叫皆由 Booking Engine 處理酒店專屬的結帳、付款與確認。
給 AI 代理 — 從這裡開始
先連接，再讀取即時合約。
Section titled “先連接，再讀取即時合約。”託管的 MCP 伺服器讓代理能發現 Wink 的 API，並建立可運作的整合，無需猜測端點。
1 · 連接 MCP 伺服器
Section titled “1 · 連接 MCP 伺服器”可串流的 HTTP 端點（SSE 回退位於 /sse）。來自 Claude Code：
claude mcp add —transport http
wink-docs https://docs.mcp.wink.travel/mcp也支援 Codex、Cursor 和 VS Code — 請參閱 MCP 文件。
2 · 搜尋即時 API
Section titled “2 · 搜尋即時 API”兩個工具將意圖解析為實際操作與概念文件：
api_search尋找要呼叫的操作 — 例如「查詢庫存」、「建立訂房」、「付款收據」docs_search尋找概念 — 「認證」、「Webhook」、「歸因」
每個結果會回傳 wink:// URI — 可開啟操作、其請求/回應結構，或其任務 配方。
3 · 使用 AI 技能建構
Section titled “3 · 使用 AI 技能建構”wink-api-builder 使用 MCP 伺服器作為真實來源：api_search → 即時合約 → 認證 → 驗證程式碼，並標示與目前 API 不符的部分。
支援 Claude Code、Codex 和 Cursor — 請參閱 AI 技能。
4 · 交接給 Booking Engine
Section titled “4 · 交接給 Booking Engine”透過 API 建立訂房，Booking Engine 負責履約 — 結帳、付款、確認及訂房同步至連接的 PMS 或渠道管理系統，並保留來源上下文。
訂閱 booking.create 及其他 63 個事件，實時反應。
一個引擎，所有整合
所有整合皆匯聚於 Booking Engine。
Section titled “所有整合皆匯聚於 Booking Engine。”無論您的產品如何傳送需求 — API、代理、元件或連結 — 訂房皆在您掌控的一處完成。
- REST API
- MCP / agents
- Web Components
- WinkLinks
- Studio + network
- Partner apps
Booking Engine
checkout · payment · confirmation
訂房確認
付款完成，賓客確認，保留歸因與來源上下文。
透過 REST + OAuth2 建構搜尋、訂房、付款、Webhook、歸因與報告工作流程 — 搭配 MCP 伺服器提供即時合約。
探索讓 AI 代理針對即時酒店供應搜尋、訂房與付款 — 完成訂房，而非僅將使用者導向網站。
探索載入酒店專屬資料並處理結帳、付款、確認與訂房完成。
探索為網站或產品介面新增可訂房的卡片、地圖、網格、按鈕與酒店模組。
探索透過一個以行動優先的公開連結發佈精選酒店條目。
探索管理合作夥伴存取、銷售渠道與合作夥伴引導的歸因上下文。
探索完整範圍
從完整 API 建構到即插即用元件。
Section titled “從完整 API 建構到即插即用元件。”可深入至完整 REST + MCP 整合 — 或當工作需求較輕時，直接使用 Studio Web Component：酒店卡片、地圖、網格與訂房模組。無論哪種方式，底層皆由 Booking Engine 履約訂房。
- 完整 REST + OAuth2 API、託管 MCP 伺服器與產生的客戶端
- 或可訂房的 Web Components — 卡片、地圖與網格
- 70 個 Webhook 事件用於即時對帳
- 每個介面底層皆由 Booking Engine 履約
開發者常見問題
技術與產品團隊最先詢問的問題。
有獨立的 API 存取產品頁面嗎？
API 存取會取代 Booking Engine 嗎？
AI 助理可以使用 Wink 嗎？
可以在沒有完整 API 整合的情況下嵌入酒店卡片或地圖嗎？
酒店集團可以使用開發者存取嗎？
開發者應該從哪裡開始？
開發者存取對所有人開放嗎？
準備好將酒店商務建構到您的產品中嗎？
Section titled “準備好將酒店商務建構到您的產品中嗎？”連接 MCP 伺服器，閱讀文件，選擇合適的整合介面。無任何限制 — 當您的產品準備好連接核准的酒店需求至 Booking Engine 履約時，即可開始。