合作夥伴 API

Wink 合作夥伴 API 是一種已驗證的高吞吐量方式，供整合者查詢可預訂的旅遊庫存 — 這是驅動我們可嵌入小工具和公開瀏覽端點的相同供應，作為一個一流的程式化介面公開。免費的 Web Components 和公開瀏覽端點適合輕量且面向使用者的嵌入，而合作夥伴 API 則為大規模搜尋、定價和預訂系統而建。存取是依整合者驗證並按使用量計費，因此您只需支付實際傳送的流量費用。

計劃與定價

使用量以 飯店住宿晚數 計量：一間飯店住宿一晚的價格 — 不是一次 API 呼叫。一次搜尋回傳 20 間飯店、3 晚住宿即為 60 飯店住宿晚數，來自單一請求。內容與查詢（目的地搜尋與自動完成）呼叫為例外：每次呼叫均計為一個單位，不論回傳多少。帳戶端點免費。定價是費率的權威來源。

	免費	付費	企業方案
價格	$0	按使用量計費	聯絡我們
適合對象	評估與低流量整合	按需付費的大規模吞吐量	客製化流量與協商條款
每月單位數	10,000	無限制	無限制
API 回應時間 (P95)	—	低於 500 毫秒	低於 500 毫秒
單位價格（飯店住宿晚數）	免費	$0.0001	客製化
超過月額配額時回應	直到下月 1 日 (UTC) 回傳 429	計費，不封鎖	依協議
服務等級協議	—	✓	✓
優先支援	—	✓	✓
專屬上線輔導	—	—	✓

取得 API 金鑰 · 開始計量計費 · 聯絡銷售

API 參考

兩個介面提供可預訂庫存，對應上述兩個層級：

免費 — 消費者 / 預訂引擎 API（REST，/api/public/**）：匿名，面向瀏覽器與小工具。瀏覽預訂引擎參考 →
付費 — 合作夥伴整合者 API（gRPC，wink.partner.v1）：已驗證、計量使用量，為大規模伺服器對伺服器整合而建。瀏覽整合者參考 →

合作夥伴整合者 API 採用 gRPC 而非 REST。您可使用產生的用戶端透過 HTTP/2 呼叫 partner.wink.travel:443，並傳遞 Bearer Token 及您要呼叫的帳戶：

grpcurl -H "authorization: Bearer $WINK_TOKEN" partner.wink.travel:443 list

上述參考頁面記錄了每個服務、訊息與錯誤狀態，且架構也可透過伺服器反射在執行時取得，因此 grpcurl、Postman 和 Insomnia 可直接發現，無需下載任何檔案。

若您想事先產生用戶端，.proto 原始檔案已發布於 github.com/wink-travel/partner-api-proto。

使用量與限制說明

免費層級

免費層級設計讓您無成本建置、測試並執行適度的生產流量。

無公開每分鐘限制。 Wink 會監控請求速率，並可能施加合理使用限制以保護服務。若收到 HTTP 429 (請求過多)，請依 Retry-After 標頭指定的秒數等待後再重試。
每月配額 — 每月 10,000 單位。 配額依帳戶授予，並於每月 1 日（UTC）重置。達到配額且未加入按使用量付費的帳戶，將於當月剩餘時間收到 HTTP 429，直到下月 1 日 — 硬性停止，附帶 Retry-After 標頭及邀請升級付費層級的訊息。已加入付費的帳戶則繼續運作，並對超出配額的使用量計費。

免費層級不包含服務等級協議或優先支援。

付費層級

付費層級取消每月上限，僅對實際使用量計費。

計量飯店住宿晚數 — 每晚 $0.0001。 無月度上限，依實際量計費。Wink 仍可能施加合理使用限制以保護服務。搜尋與庫存呼叫依飯店住宿晚數計費；內容與查詢呼叫每次計一單位，批次請求可降低費用。

付費層級包含下述服務等級協議 — 99.9% 正常運作承諾及 P95 回應時間低於 500 毫秒目標 — 以及優先且依嚴重度分類的支援。

服務等級協議

生效日期：2026 年 7 月 5 日 · 版本 1.0

本服務等級協議（以下簡稱「SLA」）訂定 Wink（「Wink」、「我們」）對客戶（「客戶」、「您」）於已聲明適用 SLA 的層級，對已驗證 Wink 合作夥伴 API（「合作夥伴 API」或「服務」）的可用性承諾、服務信用及支援目標。此 SLA 納入並受您與 Wink 間存取合作夥伴 API 之協議（「協議」）約束，且適用於您持續維持有效且付費的合作夥伴 API 訂閱。未定義之專有名詞，依協議定義。

1. 定義

「正常運作時間」 指合作夥伴 API 可接受並成功回應格式正確且已驗證請求的期間。
「停機時間」 指合作夥伴 API 未能成功回應格式正確且已驗證請求的分鐘數，排除第 4 節所列除外情況。影響極少數請求的孤立錯誤不視為停機時間。
「每月正常運作百分比」 指特定日曆月內總分鐘數減去停機分鐘數，再除以該月總分鐘數，並以百分比表示。
「預定維護」 指 Wink 依第 4 節規定提前通知的計劃性服務維護。
「服務信用」 指依受影響日曆月您支付或應付的合作夥伴 API 費用百分比計算的信用額度，作為未達正常運作承諾的唯一且排他性補償，並可抵扣未來合作夥伴 API 費用。
「回應時間」 指 Wink 於服務邊界收到格式正確且已驗證請求起，至開始回傳回應之間的經過時間，不含網路傳輸及 Wink 無法控制的用戶端時間。

2. 可用性與效能承諾

Wink 將以商業合理努力，確保合作夥伴 API 在每個日曆月達成 至少 99.9% 的每月正常運作百分比（「正常運作承諾」）。正常運作承諾於 Wink 服務邊界測量，排除第 4 節所述 Wink 合理無法控制之因素。Wink 監控系統為每月正常運作百分比與回應時間的權威紀錄來源。

Wink 進一步目標為成功、格式正確且已驗證請求達成 第 95 百分位數（P95）回應時間低於 500 毫秒（「效能目標」），於每月於 Wink 服務邊界測量。效能目標排除第 4 節因素、因請求本身造成的應用層錯誤，以及異常大型或複雜批次請求。效能目標為服務目標；第 3 節服務信用僅適用於未達 正常運作承諾，且為可用性不足的唯一且排他性補償。

3. 服務信用

若任一日曆月每月正常運作百分比低於正常運作承諾，您可依下表比例申請服務信用，計算基礎為該月您支付或應付的合作夥伴 API 費用：

每月正常運作百分比	服務信用
低於 99.9% 但不低於 99.0%	10%
低於 99.0% 但不低於 95.0%	25%
低於 95.0%	50%

申請信用。 您必須於停機事件發生之日曆月結束後 三十（30）天內 向 Wink 提交書面申請。申請須包含您主張的每次停機日期與時間，以及您合理可取得的任何支援日誌或證據。逾期申請不予受理。
信用形式。 核准的服務信用將抵扣未來合作夥伴 API 費用，無現金價值。非退款，除非適用法律另有規定。
最高信用額度。 單一日曆月所授予的服務信用總額不超過該月您支付或應付的合作夥伴 API 費用 50%。
唯一且排他性補償。 服務信用為您因 Wink 未達正常運作承諾或其他可用性不足的 唯一且排他性補償。

4. 除外情況

正常運作承諾及服務信用不適用於，且停機時間不包含，因下列原因導致的任何不可用、暫停、降級或效能問題：

Wink 已提前通知的 預定維護，且通知時間合理，透過 Wink 通常用於與客戶溝通的管道；
不可抗力 事件或 Wink 合理無法控制的其他原因，包括天災、政府行為、網路或公用事業故障，以及阻斷服務或其他惡意攻擊；
因您的行為或疏忽、您的設備、軟體或網路，或任何非 Wink 直接控制的 第三方 服務、產品或供應商所致問題；
您對服務的濫用或 違反協議、本 SLA、可接受使用條款或適用速率限制，包括 Wink 合理判定的過度流量、自動化濫用或詐欺行為；
根據協議正當執行的任何 暫停或終止 您的存取權，包括因未付款而暫停。

5. 支援與回應目標

Wink 於標準營業時間提供合作夥伴 API 支援，不含當地公共假日。Wink 將以商業合理努力，依您指定且 Wink 合理確認的嚴重度，在下列目標回應時間內回覆已妥善提交的支援請求：

嚴重度	說明	目標初次回應時間
Sev 1 — 致命	合作夥伴 API 在生產環境中無法使用且無替代方案。	4 小時
Sev 2 — 重大	重要功能受損或降級；有替代方案。	1 個工作日
Sev 3 — 輕微	一般問題、次要問題或功能請求。	2 個工作日

目標回應時間指 Wink 旨在達成的 初次聯繫 時間，非解決時間保證。優先支援與依嚴重度分類的目標僅適用於明確包含此服務的層級。

6. 資料與安全

Wink 採取商業合理的管理、技術與組織措施，保護透過合作夥伴 API 處理資料的機密性、完整性與可用性，並定期檢視這些措施。Wink 對個人資料的處理受隱私政策及協議中任何資料處理條款約束。您須自行負責保護 API 憑證安全、合法使用所取得資料，並於懷疑憑證遭洩漏時，立即通知 Wink。

7. 責任限制

服務信用為因未達正常運作承諾所致不可用性的 唯一且排他性補償，並取代因該等失效產生的其他任何責任。除本 SLA 明確規定外，合作夥伴 API 以「現況」提供。於適用法律允許最大範圍內，Wink 因服務所生或相關的總體責任依協議規定限制，且 Wink 不負責任何間接、附帶、特殊、衍生或懲罰性損害賠償，亦不負責利潤、收入、資料或商譽損失，即使已被告知可能發生此類損害。

8. 期限、變更與終止

本 SLA 適用於您持有明確包含 SLA 的有效合作夥伴 API 訂閱期間。Wink 可不時更新本 SLA；重大變更將透過 Wink 通常用於聯繫客戶的管道通知，且您於更新生效後繼續使用合作夥伴 API 即表示接受更新後的 SLA。本 SLA 於協議或您的合作夥伴 API 訂閱終止或到期時自動終止。因其性質應於終止後繼續有效的條款 — 包括累積但未申請的服務信用資格、責任限制及定義 — 將繼續有效。