回调 URL

回调 URL 主要用于与第三方系统对接。当发生指定动作时系统将会以 POST 的方式将数据实时推送到指定的 URL，第三方系统在接收后做相应业务处理。

配置触发器

推送到 (URL)

向哪个 URL 推送数据。

建议使用 https://webhook.site 测试回调 URL，以便观察不同动作所产生的数据样例

安全码

填写后，系统在调用时会携带在请求头 Header 中，三方系统可以通过此安全码进行安全验证。

校验返回结果

启用后系统将以同步方式进行推送（不启用则为异步），若返回结果为 SUCCESS 则成功，否则将失败。请注意启用此选项后若返回结果不是 SUCCESS 会导致用户操作失败。

推送全量数据

启用后，在新建、更新、分配、审批以及定时执行时，将推送记录的全部字段数据（包括明细）。不启用则仅推送发生变更的字段数据。

推送关联数据 ~~v4.4

启用后会推送选择的关联实体数据，推送的数据放在 $RELATEDS$ 字段中。可选择多个关联实体，每个关联实体的数据格式与主记录一致。

推送测试

点击 [推送测试] 按钮可向已配置的 URL 发送一条测试数据（action 为 RBHOOK-TEST），用于验证 URL 是否可达及返回结果是否符合预期。

推送数据示例

{
  "user": "002-0000000000000000",     // 操作人
  "action": "DELETE",                 // 动作，如 CREATE 创建、UPDATE 更新、DELETE 删除等
  "recordId": "999-0000000000000001", // 记录ID
  "recordData": {},                   // 记录数据（如有）
  "$DETAILS$": [],                    // 明细数据（如有）
  "$RELATEDS$": []                    // 关联数据（如有）
}

建议使用 https://webhook.site 测试回调 URL，以便观察不同动作所产生的数据样例

常见问题

编辑一次为何会推送多次

你可能启用了触发器（如字段更新）。用户手动更新触发一次，触发器根据触发动作又进行了一次或多次更新，此类情况系统并不会合并推送，需你自行处理。

请求超时时间是多少

回调请求的超时时间为 30 秒，即如果目标 URL 在 30 秒内未响应，请求将超时失败。

请求失败后会自动重试吗

会。当目标 URL 返回非 200 状态码时，系统会自动重试，最多重试 3 次，重试间隔递增（15 秒、30 秒、45 秒）。