合作夥伴 API

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

計劃與定價

一次 API 呼叫 = 一次請求。計量使用量以每 1,000 次請求計費。

	免費	付費	企業
價格	$0	按使用量計費	聯絡我們
適合對象	評估與低流量整合	按需付費的大規模吞吐量	客製化流量與協商條款
每分鐘請求數	30（突發 60）	無限制	無限制
每月請求數	10,000	無限制	無限制
API 回應時間 (P95)	—	低於 500 毫秒	低於 500 毫秒
每 1,000 請求價格	免費	$1.00	客製化
超出查詢與預訂比率（每超出 5,000:1 的 1,000 次查詢）	—	$2.00	客製化
速率限制回應	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。

使用量與限制說明

免費層級

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

速率限制 — 每分鐘 30 次請求，突發可達 60 次。 短暫超過持續速率的峰值由突發配額吸收。若超出，API 將回應 HTTP 429（請求過多），並對您的金鑰施加 5 分鐘暫停，暫停期間請勿持續重試，請在暫停結束後再嘗試。
每月配額 — 每日曆月 10,000 次請求。 達到月度上限後，API 將於該月剩餘期間回應 HTTP 429 — 硬性停止，並附上訊息邀請您升級付費層級繼續使用。計數器於下一個月初重置。

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

付費層級

付費層級取消月度上限與速率限制暫停，並僅依實際使用量計費。

計量請求 — 每 1,000 次請求 $1.00。 無月度請求上限，正常使用下無速率限制節流，依實際流量計費。
查詢與預訂比率超額 — 每 1,000 次超額查詢 $2.00。 為維持供應健康，我們會計量搜尋（「查詢」）與確認預訂的比例。您享有 每筆預訂 5,000 次查詢 的免費額度。超額查詢計算方式為：

excess = max(0, 查詢數 − 預訂數 × 5,000)

超額部分將以 每 1,000 次超額查詢 $2.00 計費。轉換率良好的整合通常不會產生超額費用；此費用僅適用於搜尋遠多於預訂的流量。

付費層級包含下述服務等級協議 — 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 訂閱終止或到期時自動終止。因其性質應於終止後繼續有效的條款 — 包括累積但未申請的服務抵免資格、責任限制及定義 — 將繼續有效。