使用webhooks将事件发送到您自己的系统

Webhook允许IDup在发生某事时立即调用您的网络地址，例如发票支付时。每次传递都经过签名，如果您的系统没有响应，则会重复。

添加一个端点

1. 打开 Webhooks 选项卡并按 添加端点.
2. 输入一个 姓名 和 URL。它必须是公开可访问的。出于安全原因，拒绝私人网络内的地址。
3. 勾选 事件 您想要的。
4. 可选：选择一个 API密钥。然后，端点仅接收此密钥可以读取的事件。
5. 按 保存。IDup 显示 您的签名密钥 一次。请妥善保存。

事件

• 发票已创建, 发票已支付, 已收到付款
• 新客户, 新联系人, 新潜在客户, 新工单
• 报价已接受 — 客户接受的报价

每个交付都有三个标题：事件名称、交付编号和签名。重试保持相同的交付编号，因此您的系统可以识别重复项。

检查签名

您的系统应使用您的密钥对时间和原始主体计算 HMAC-SHA256，与签名进行比较，并拒绝超过 5 分钟的时间。按 验证签名和示例 用于现成的代码。

测试、暂停和续订

• 发送测试 发送测试事件并显示HTTP代码和所用时间。
• 暂停 停止交付； 激活 重新启动它们。
• 滚动密钥 创建一个新密钥。旧密钥立即停止工作。
• 删除 移除端点。其日志会被保留。

重试和日志

您的地址必须在5秒内以2xx代码响应。重定向不被跟随。如果失败，IDup将在1分钟、5分钟、30分钟、2小时和12小时后再次尝试。第六次尝试后，交付被标记。 放弃.

日志显示每次尝试的事件、端点、尝试次数、HTTP代码、持续时间和答案的开始。状态是 等待中, 已交付, 失败 或 放弃。使用 重新发送 再次发送交付。