合作伙伴 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 在服务边界收到格式正确、经过身份验证请求到开始返回响应的时间,不包括网络传输和 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 未达到正常运行时间承诺或合作伙伴 API 任何其他可用性不足的 唯一且排他性补救。
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 订阅终止或到期时自动终止。按性质应在终止后继续有效的条款——包括已产生但未申领的服务信用资格、责任限制和定义——继续有效。
