合作伙伴 API
Wink 合作伙伴 API 是经过身份验证的高吞吐量接口,供集成商查询可预订的旅游库存——这与驱动我们可嵌入小部件和公共浏览端点的供应相同,作为一流的编程接口公开。免费 Web 组件和公共浏览端点适合轻量级、面向用户的嵌入,而合作伙伴 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 参考
Section titled “API 参考”两个 OpenAPI 接口提供可预订库存,分别对应上述两个层级:
- 免费 — 消费者 / 预订引擎 API (
/api/public/**):匿名,面向浏览器和小部件。浏览预订引擎参考 → - 付费 — 合作伙伴集成商 API (
/api/partner/**):经过身份验证,按使用量计费,专为大规模服务器间集成设计。浏览集成商参考 →
使用和限制说明
Section titled “使用和限制说明”免费层旨在让您构建、测试并运行适度的生产流量,且无需付费。
- 速率限制 — 每分钟 30 次请求,允许 60 次突发。 短时间内超过持续速率的请求由突发额度吸收。若超出,API 将返回 HTTP 429(请求过多) 并应用 5 分钟暂停,暂停结束后密钥恢复服务。请在暂停窗口后重试,避免频繁请求。
- 月度配额 — 每日历月 10,000 次请求。 达到月度上限后,API 在当月剩余时间内返回 HTTP 429,即硬停止,并提示您订阅付费层以继续使用。计数器在下一个日历月初重置。
免费层不包含服务级别协议或优先支持。
付费层取消月度上限和速率限制暂停,仅按实际使用量计费。
-
计量请求 — 每 1,000 次请求 $1.00。 无月度请求上限,正常使用下无速率限制节流,按实际流量计费。
-
预订转化超额 — 每 1,000 次超额搜索 $2.00。 为保持供应健康,我们对搜索(“浏览”)与确认预订的比例进行计量。您享有 每笔预订 5,000 次浏览 的额度,超额浏览按以下公式计算:
excess = max(0, looks − bookings × 5,000)超额部分按 每 1,000 次超额浏览 $2.00 计费。转化率高的集成很少产生超额费用;该费用仅适用于搜索远超预订的流量。
付费层包含下述服务级别协议——99.9% 正常运行时间承诺和 P95 响应时间目标低于 500 毫秒——以及优先、基于严重性的支持。
服务级别协议
Section titled “服务级别协议”生效日期:2026 年 7 月 5 日 · 版本 1.0
本服务级别协议(“SLA”)规定了 Wink(“Wink”、“我们”)向客户(“客户”、“您”)提供的经过身份验证的 Wink 合作伙伴 API(“合作伙伴 API”或“服务”)的可用性承诺、服务信用和支持目标,适用于声明适用 SLA 的层级。本 SLA 纳入您与 Wink 之间访问合作伙伴 API 的协议(“协议”)并受其约束,适用于您保持有效且良好状态的付费合作伙伴 API 订阅期间。未在此定义的术语含义以协议中定义为准。
- “正常运行时间” 指合作伙伴 API 可接受并成功响应格式正确、经过身份验证请求的时间段。
- “停机时间” 指合作伙伴 API 未能成功响应格式正确、经过身份验证请求的时间段(以分钟计),不包括第 4 节中列出的排除情况。影响极少请求的孤立错误本身不构成停机时间。
- “月度正常运行百分比” 指某日历月内总分钟数减去停机分钟数,再除以该月总分钟数,结果以百分比表示。
- “计划维护” 指 Wink 按第 4 节规定提前通知的服务计划维护。
- “服务信用” 指按您当月为合作伙伴 API 支付或应付费用的百分比计算的信用额度,作为未达到正常运行时间承诺的唯一且排他性补救措施,抵扣未来合作伙伴 API 费用。
- “响应时间” 指 Wink 在服务边界收到格式正确、经过身份验证请求到开始返回响应的时间,不包括网络传输和客户端控制之外的时间。
2. 可用性与性能承诺
Section titled “2. 可用性与性能承诺”Wink 将尽商业合理努力确保合作伙伴 API 在每个日历月的 月度正常运行百分比至少为 99.9%(“正常运行时间承诺”)。正常运行时间承诺在 Wink 服务边界测量,不包括第 4 节中描述的不可控因素。Wink 的监控系统为月度正常运行百分比和响应时间的权威记录。
Wink 还设定了成功、格式正确、经过身份验证请求的 第 95 百分位(P95)响应时间低于 500 毫秒 的目标(“性能目标”),在 Wink 服务边界按月测量。性能目标不包括第 4 节描述的因素、因请求本身导致的应用级错误以及异常大或复杂的批量请求。性能目标为服务目标;第 3 节的服务信用仅适用于未达到 正常运行时间承诺 的情况,是可用性不足的唯一且排他性补救。
3. 服务信用
Section titled “3. 服务信用”若月度正常运行百分比低于正常运行时间承诺,您可根据以下阶梯获得按当月合作伙伴 API 费用计算的服务信用:
| 月度正常运行百分比 | 服务信用 |
|---|---|
| 低于 99.9% 但不低于 99.0% | 10% |
| 低于 99.0% 但不低于 95.0% | 25% |
| 低于 95.0% | 50% |
- 申请信用。 您必须在发生故障的日历月结束后 30 天内 向 Wink 提交书面申请,包含每次停机事件的日期和时间及您合理可提供的支持日志或证据。逾期申请不予受理。
- 信用形式。 经批准的服务信用用于抵扣未来合作伙伴 API 费用,无现金价值,不是退款,除非适用法律另有规定。
- 最高额度。 单个日历月累计服务信用不超过您当月为合作伙伴 API 支付或应付费用的 50%。
- 唯一且排他性补救。 服务信用是您因 Wink 未达到正常运行时间承诺或其他可用性不足而享有的 唯一且排他性补救。
4. 排除项
Section titled “4. 排除项”正常运行时间承诺及服务信用不适用于,且停机时间不包括因以下原因导致的任何不可用、暂停、性能下降或问题:
- Wink 已提前合理通知的 计划维护,通知通过 Wink 通常用于客户沟通的渠道发送;
- 超出 Wink 合理控制范围的 不可抗力 事件,包括自然灾害、政府行为、网络或公用设施故障、拒绝服务或其他恶意攻击;
- 由 您 的行为或疏忽、设备、软件或网络,或任何非 Wink 直接控制的 第三方 服务、产品或供应商引起的问题;
- 您对服务的 滥用 或 违反协议、本 SLA、可接受使用条款或适用速率限制,包括 Wink 合理认定的过度流量、自动化滥用或欺诈行为;
- 根据协议正当执行的对您访问的 暂停或终止,包括因未付款而暂停。
5. 支持与响应目标
Section titled “5. 支持与响应目标”Wink 在标准工作时间内(不含当地公共假期)提供合作伙伴 API 支持。Wink 将尽商业合理努力在以下目标响应时间内确认收到您正确提交的支持请求,响应时间基于您指定且 Wink 合理确认的严重级别:
| 严重级别 | 描述 | 目标首次响应时间 |
|---|---|---|
| Sev 1 — 严重 | 合作伙伴 API 在生产环境中宕机或不可用,无可行替代方案。 | 4 小时 |
| Sev 2 — 主要 | 重要功能受损或降级,有可行替代方案。 | 1 个工作日 |
| Sev 3 — 次要 | 一般问题、轻微故障或功能请求。 | 2 个工作日 |
目标响应时间指 Wink 旨在进行 首次联系 的时间,不保证解决时间。优先支持和基于严重级别的目标适用于声明包含的层级。
6. 数据与安全
Section titled “6. 数据与安全”Wink 维持商业合理的管理、技术和组织措施,保护通过合作伙伴 API 处理的数据的机密性、完整性和可用性,并定期审查这些措施。Wink 对个人数据的处理受隐私政策及协议中的数据处理条款约束。您负责保护自己的 API 凭证安全,合法使用检索的数据,并及时通知 Wink 任何疑似凭证泄露。
7. 责任限制
Section titled “7. 责任限制”服务信用是您因不可用或未达到正常运行时间承诺而享有的 唯一且排他性补救,替代因该等失败产生的任何其他责任。除本 SLA 明确规定外,合作伙伴 API 按“现状”提供。在适用法律允许的最大范围内,Wink 因服务产生或相关的累计责任受协议限制,且不对任何间接、附带、特殊、后果性或惩罚性损害赔偿负责,包括利润、收入、数据或商誉损失,即使已被告知可能发生此类损害。
8. 期限、变更与终止
Section titled “8. 期限、变更与终止”本 SLA 适用于您拥有声明适用 SLA 层级的有效合作伙伴 API 订阅期间。Wink 可不时更新本 SLA;重大变更将通过 Wink 通常用于客户沟通的渠道通知,您继续使用合作伙伴 API 即视为接受更新后的 SLA。本 SLA 在协议或您的合作伙伴 API 订阅终止或到期时自动终止。按性质应在终止后继续有效的条款——包括已产生但未申领的服务信用资格、责任限制和定义——继续有效。
