合作伙伴 API
Wink 合作伙伴 API 是经过身份验证的高吞吐量接口，供集成商查询可预订的旅游库存——这与驱动我们可嵌入小部件和公共浏览端点的供应相同，作为一流的编程接口公开。免费 Web 组件和公共浏览端点适合轻量级、面向用户的嵌入，而合作伙伴 API 则为大规模搜索、定价和预订的系统而建。访问按集成商身份验证，并按使用量计费，因此您只需为实际发送的流量付费。
使用量以酒店夜数计量：一间酒店按一晚住宿计价——不是一次 API 调用。一次返回 20 家酒店、3 晚住宿的搜索请求即为 60 酒店夜数。内容和查找（目的地搜索和自动完成）调用是例外：每次调用计费一个单位，无论返回多少。账户端点免费。定价 是费率的权威来源。
| 免费 | 付费 | 企业 | |
|---|---|---|---|
| 价格 | $0 | 按使用量计费 | 联系我们 |
| 适用场景 | 评估和低流量集成 | 按需付费的大规模吞吐量 | 定制流量和协商条款 |
| 每月单位数 | 10,000 | 无限 | 无限 |
| API 响应时间 (P95) | — | 低于 500 毫秒 | 低于 500 毫秒 |
| 单位价格（酒店夜数） | 免费 | $0.0001 | 定制 |
| 达到月度额度时响应 | 直到下月 1 日（UTC）返回 429 | 计费，不阻止 | 按协议 |
| 服务级别协议 | — | ✓ | ✓ |
| 优先支持 | — | ✓ | ✓ |
| 专属入门指导 | — | — | ✓ |
API 参考
Section titled “API 参考”两个接口提供可预订库存，分别对应上述两个层级：
- 免费 — 消费者 / 预订引擎 API（REST，
/api/public/**）：匿名，面向浏览器和小部件。浏览预订引擎参考 → - 付费 — 合作伙伴集成 API（gRPC，
wink.partner.v1）：经过身份验证，按使用量计费，专为大规模服务器间集成设计。浏览集成参考 →
合作伙伴集成 API 是 gRPC，不是 REST。您通过生成的客户端在 HTTP/2 上调用
partner.wink.travel:443，传递 Bearer 令牌和调用的账户：
grpcurl -H "authorization: Bearer $WINK_TOKEN" partner.wink.travel:443 list上述参考页面记录了所有服务、消息和错误状态，且架构在运行时通过服务器反射可用，因此 grpcurl、Postman 和 Insomnia 可自动发现，无需下载任何内容。
如果您希望提前生成客户端，.proto 源文件发布在
github.com/wink-travel/partner-api-proto。
使用量和限制说明
Section titled “使用量和限制说明”免费层旨在让您构建、测试并以零成本运行适度的生产流量。
- 无公开的每分钟限制。 Wink 会监控请求速率，可能会施加合理使用限制以保护服务。如果收到 HTTP 429（请求过多），请等待
Retry-After头指定的秒数后重试。 - 每月额度——每个日历月 10,000 单位。 额度按账户授予，每月 1 日（UTC）重置。达到额度且未注册按使用付费的账户将收到 直到下月 1 日的 HTTP 429——硬性停止，带有
Retry-After头和邀请订阅付费层的消息。注册账户可继续使用，超出额度部分按使用计费。
免费层不包含服务级别协议或优先支持。
付费层取消月度上限，仅按实际使用计费。
- 计量酒店夜数——每酒店夜数 $0.0001。 无月度上限，按实际量计费。Wink 仍可能施加合理使用限制以保护服务。搜索和库存调用按定价的酒店夜数计费；内容和查找调用每次计费一个单位，因此批量请求可降低费用。
付费层包含下述服务级别协议——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 的监控系统是测量月度正常运行时间百分比和响应时间的权威记录。
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 将尽商业合理努力在您提交的支持请求被合理确认的严重级别基础上，达到以下目标响应时间：
| 严重级别 | 描述 | 目标首次响应时间 |
|---|---|---|
| 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 订阅终止或到期时自动终止。按性质应在终止后继续有效的条款——包括已产生但未申领的服务信用资格、责任限制和定义——继续有效。