跳到內容
給開發者

API 優先的酒店商務:搜尋、訂房、付款、64+ Webhook、歸因與 AI 交接 — 搭配託管 MCP 伺服器讓代理讀取即時合約,底層由 Booking Engine 履約。

REST + OAuth2 + SDKs 託管 MCP 伺服器 64+ webhook 事件
wink · agent integration live

# 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.created 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 防護,避免虛構可用性
  • 隨著酒店每日變動持續維護
  • 整合來自 Extranet 的酒店核准供應
  • Booking Engine 處理結帳、付款與確認
  • 每次點擊保留 6 個月歸因
  • 訂閱 64+ webhook 事件
  • 透過 MCP + Agentic AI 結構化 AI 交接
  • 5.5% 全包費用 — 每次交接底層皆由 Booking Engine 支援

運作模式

從連接到履約的一條整合路徑。

  1. 1

    連接

    新增託管 MCP 伺服器或申請帶 OAuth2 的 API 存取,開始對即時合約操作。

  2. 2

    讀取即時合約

    搜尋操作並讀取當前請求與回應結構 — 無需猜測,無過時文件。

  3. 3

    建構流程

    將搜尋、可用性、訂房、付款與報告串接到您的產品中。

  4. 4

    訂閱事件

    回應 64+ webhook 事件:訂房狀態、付款、退款、取消與渠道變更。

  5. 5

    由 Booking Engine 履約

    每次呼叫皆由 Booking Engine 處理酒店專屬結帳、付款與確認。

給 AI 代理 — 從這裡開始

託管的 MCP 伺服器讓代理能發現 Wink 的 API,並建立可運作的整合,無需猜測端點。

可串流 HTTP 端點(SSE 回退位於 /sse)。來自 Claude Code:

claude mcp add —transport http 
wink-docs https://docs.mcp.wink.travel/mcp

也支援 Codex、Cursor 和 VS Code — 請參閱 MCP 文件

兩種工具將意圖解析為實際操作與概念文件:

  • api_search尋找要呼叫的操作 — 例如「查詢庫存」、「建立訂房」、「付款收據」
  • docs_search尋找概念 — 「認證」、「webhooks」、「歸因」

每個結果會回傳 wink:// URI — 可開啟操作、其請求/回應結構,或其任務 配方

wink-api-builder 使用 MCP 伺服器作為真實來源:api_search → 即時合約 → 認證 → 驗證程式碼,並標示與目前 API 不符的部分。

支援 Claude Code、Codex 和 Cursor — 請參閱 AI 技能

透過 API 建立訂房,Booking Engine 負責履約 — 結帳、付款、確認及訂房同步至連接的 PMS 或渠道管理系統,並保留來源情境。

訂閱 booking.created 及其他 63 個事件,實時回應。

一個引擎,所有整合

所有整合皆匯聚於 Booking Engine。

Section titled “所有整合皆匯聚於 Booking Engine。”

無論您的產品如何傳送需求 — API、代理、元件或連結 — 訂房皆在您掌控的單一位置完成。

  • REST API
  • MCP / agents
  • Web Components
  • WinkLinks
  • Studio + network
  • Partner apps

Booking Engine

checkout · payment · confirmation

訂房確認

付款完成、賓客確認,保留歸因與來源情境。

完整範圍

從完整 API 建構到即插即用元件。

Section titled “從完整 API 建構到即插即用元件。”

深入到完整 REST + MCP 整合 — 或當工作需求較輕時,直接使用 Studio Web Component:酒店卡片、地圖、網格與訂房模組。無論哪種方式,底層皆由 Booking Engine 履約訂房。

  • 完整 REST + OAuth2 API、託管 MCP 伺服器與 SDK
  • 或可訂房的 Web Components — 卡片、地圖與網格
  • 64+ webhook 事件支援即時對帳
  • 每個介面底層皆由 Booking Engine 履約
查看 Build on Wink 文件
一個 Wink 可嵌入的酒店卡片 Web Component

開發者常見問題

技術與產品團隊最先詢問的問題。

有獨立的 API 存取產品頁面嗎?
沒有。API 存取是透過 Builders 頁面和 Build on Wink 文件處理,而非獨立的行銷產品頁面。
API 存取會取代 Booking Engine 嗎?
不會。API 存取負責需求路由和整合邏輯。Booking Engine 仍是酒店專屬結帳、付款、確認和訂房完成的履約層。
AI 助理可以使用 Wink 嗎?
可以。託管的 MCP 伺服器讓 AI 代理能讀取即時 API 合約,進行即時酒店供應搜尋、建立訂房並透過 Booking Engine 付款 — 完成一個流程的訂房,而非僅將使用者導向網站。任何酒店一旦在 Wink 上線,即可供代理使用。
可以在沒有完整 API 整合的情況下嵌入酒店卡片或地圖嗎?
可以。Studio 可建立 Web Components,如酒店卡片、地圖、網格及其他嵌入資產,當較輕量的路徑足夠時 — 底層由 Booking Engine 履約訂房。
酒店集團可以使用開發者存取嗎?
可以。經核准的酒店集團及技術營運者可使用開發者存取,將 Wink 供應、訂房及報告工作流程與內部系統連接。
開發者應該從哪裡開始?
連接 MCP 伺服器,閱讀 Build on Wink 文件,當產品使用案例、技術範圍及商業路徑明確後,再申請 API 存取。
開發者存取對所有人開放嗎?
開發者存取應受控。公開文件和 MCP 伺服器可支援評估,但 API 憑證和正式使用應符合核准的產品及商業情境。

準備好將酒店商務整合進您的產品了嗎?

Section titled “準備好將酒店商務整合進您的產品了嗎?”

連接 MCP 伺服器,閱讀文件,選擇合適的整合介面,當您的產品準備好連接核准的酒店需求至 Booking Engine 履約時,申請存取。