Webhook 集成
Webhook 让您的系统能够在 Wink 账户发生事件时接收实时通知——新预订、取消、支付更新等。本文将引导您完成设置及最佳实践。
本指南适用于将 Wink 与外部系统（如物业管理系统（PMS）、渠道管理器、CRM 或自定义仪表盘）集成的开发者。
webhook 工作原理
Section titled “webhook 工作原理”- 您在 Wink 上注册 webhook URL。
- 当事件发生（例如新预订），Wink 会向您的 URL 发送 HTTP POST 请求。
- 您的服务器处理负载并返回
200 OK。
设置 webhook
Section titled “设置 webhook”- 登录您的账户（Extranet、Studio 或 TripPay 均支持 webhook）。
- 进入
Applications，然后选择Webhooks。参见 Webhooks。 - 点击
Create webhook。 - 输入 名称（例如 “PMS 预订同步”）。
- 输入您的 webhook URL —— 您服务器上的 HTTPS 端点。
- 选择事件 —— 选择要订阅的特定事件，或留空以接收所有事件。
- 切换 Enabled 为开启状态。
- 点击
Save。
Wink 支持 64+ 种 webhook 事件类型，涵盖账户管理、预订合同、支付、渠道管理器更新及实体管理等类别。常见事件包括：
| 类别 | 示例 |
|---|---|
| 预订 | booking.create，booking.cancelled |
| 预订合同 | booking.contract.created，booking.contract.processing，booking.contract.cancelled |
| 支付 | internal.payment.succeeded，internal.payment.failed |
| 退款 | booking.contract.refund.partial，booking.contract.refund.full |
| 渠道管理器 | channel-manager.update.rate，channel-manager.update.availability |
| 账户 | account.create，account.status.updated |
完整的事件类型及描述列表，请参见 Webhook 事件目录。
查看全部 64+ 事件类型
- 使用 HTTPS —— Wink 仅向 HTTPS 端点发送负载。
- 快速响应 —— 收到负载后尽快返回
200 OK，重负载处理请异步进行。 - 幂等性 —— 处理程序应保持幂等。若未收到
200响应，Wink 可能会重试发送。 - 验证来源 —— 处理前请验证请求确实来自 Wink。
- 日志记录 —— 记录每个接收到的 webhook 负载，便于调试集成问题。
您可以 禁用 webhook 而不删除它。这样可以暂停通知发送，方便排查问题且不丢失配置。准备好后可重新启用。
删除 webhook 会永久移除它。依赖该 webhook 的集成将停止接收通知。
- Webhook 事件目录 —— 全部 64+ 事件类型完整列表。
- Webhooks —— webhook 管理完整参考。
- Applications —— 管理您的 API 凭证。
- Developers > APIs —— 完整 API 文档。