事件
| 事件 | 发送时机 |
|---|---|
| client.created | 新增客户。 |
| order.submitted | 提交订单。 |
| order.approved | 订单获批。 |
| order.settled | 订单结算并发行份额。 |
| distribution.approved | 分配获批。 |
| transfer.completed | 投资者之间的转让完成。 |
| message.received | 客户发送消息。 |
载荷包含 ID、数字和金额，但不含个人数据。您的系统通过 API 密钥获取详细信息。
添加端点
- 打开设置，再打开 Webhook，选择添加端点。
- 输入能在几秒内返回 2xx 状态的
https地址。选择事件。 - 复制签名密钥。仅显示一次。
- 选择发送测试事件以检查是否收到。
- 仅接受公共主机上的
https地址。指向私有或内部网络的地址会被拒绝。 - 不跟随重定向。
验证签名
每次投递为 JSON POST，包含请求头 EasyHaus-Event、EasyHaus-Delivery 和 EasyHaus-Signature。签名格式为 t=<unix time>,v1=<hex>。使用密钥对文本 <t>.<raw body> 计算 HMAC-SHA256，与 v1 比较，并拒绝过旧的时间戳。
请求体为 {id, type, created_at, organization_id, data}。
重试及关闭
- 请在 10 秒内响应。投递失败后会以逐渐增加的间隔重试，最多尝试 10 次。
- 连续失败 20 次后，端点关闭，所有者和管理员收到邮件。修复后重新开启，将重置计数。
- 投递日志显示每次投递、状态及 HTTP 代码，并允许重新投递。
- 您可以编辑事件、关闭端点、轮换密钥（旧密钥立即失效）或删除端点。