所有指南
Webhook
当投递状态变化时向你的服务器发出 HTTP 回调:无需轮询,数据实时送达。
要点
- 始终验证传入请求的 HMAC 签名:它能保证负载确实来自 NotifyHub。
- 快速返回 2xx 响应,并以异步方式处理负载:响应过慢会触发重试。
- 使用 Webhook 投递日志进行调试:它会显示负载、你服务器的响应以及重试情况。
本页面的作用
Webhook 会在 NotifyHub 中发生事件时通知你的系统,通常是投递状态的变化(已送达、失败等)。你注册自己服务器的 URL 和关注的事件:每次事件发生时,NotifyHub 都会发送一个带完整负载的签名 HTTP 请求。
使用方法
表格列出各端点的 URL、已订阅的事件、状态和最近触发时间。可通过开关启用/停用某个端点(在你的服务器维护期间非常有用),也可以将其删除。请求采用 HMAC 签名:用于验证的密钥会在创建端点时提供。
投递与重试
对你端点的每次调用都会记录在 Webhook 投递页面中,包括发送的负载、响应代码和尝试次数:如果你的服务器出错,NotifyHub 会自动重试,你也可以手动重发失败的投递。如果你的端点长时间不可用,请查看日志以找回遗漏的事件。