我如何接收验证更新？

简短回答

在正确的环境中创建 Webhook 端点并订阅集成所需的事件。验证签名、存储逻辑事件 ID 并在后端处理更新。申请人的完成屏幕不能替代经过验证的结果。

订阅正确的更改

初始检查完成和后来的状态更改有不同的目的。订阅记录的验证结果事件，并在您的系统需要审阅者、工作流程或重新提交更改时添加状态更新事件。较旧的端点可能无法订阅创建后添加的事件。

使用事件目录和当前事件系列文档来获取确切的负载。不要围绕从另一个产品的示例发明的字段构建处理程序。

安全处理交付

在信任负载之前，根据原始请求字节验证当前签名方案。将每个端点的签名机密保存在服务器的机密存储中并使用匹配的环境。在验证之前解析并重新序列化主体可能会破坏签名。

保留信封事件 ID 以消除重复的业务操作。手动重新发送可以为同一逻辑事件创建另一个传送记录。不保证跨活动的交付顺序；比较资源的版本或读取决策重要的当前状态。

及时确认已接受的交付并通过您自己的持久处理异步执行较慢的工作。不要确认您无法安全保留进行处理的事件。

上线前测试

在 Sandbox 中使用控制台的 Webhook 测试操作，检查传送历史记录并重新发送事件。确认其业务效果发生一次。练习失败的响应、重试、无效签名和无序更改。然后配置并测试单独的生产端点和密钥。

相关指南

• Webhook概述
• 签名验证
• Webhook测试