Webhook
事件推送到 HTTPS 端点的机制:回执、上行消息与状态变更,接收方必须验签、快速应答并入队。
仅解释——此处解释的术语不是我们销售的服务。
Webhook 是一种 HTTPS 回调:事件发生时,服务商向您登记的 URL 推送事件,例如送达回执或上行消息。接收方验证签名、返回 2xx 确认,再将任务放入队列。
接收方要处理重复和乱序事件。Webhook 属于推送式投递。
验签、确认、入队
事件发生时,服务商发出 POST,您的端点返回 2xx 即表示确认。载荷通常是 JSON,包含事件类型和标识符。服务商可能对载荷签名。用共享密钥把签名与原始请求体比对,并拒绝重放窗口之外的请求。
先验证,再保存原始事件,返回 2xx,然后异步处理。端点响应慢会触发重试。投递通常是至少一次,顺序也不固定,所以要按事件 ID 去重。无法处理的事件放进死信队列。SMPP 与 HTTP 对比说明了回调与基于会话的投递有何不同。