Webhooks
巴克励步
概述
资源库 Webhooks（
/dam/webhooks）在资源 创建、更新、删除 等事件发生时，向配置的 URL 发送 HTTP 请求，便于同步外部 DAM、工单系统或自建索引。操作步骤
步骤一：进入 Webhooks 列表
- 进入 资源库 → 管理 → Webhooks。
- 阅读页顶安全说明：妥善保管回调 URL 与密钥；生产环境建议校验签名并限制来源。
预期结果：看到已配置的 Webhook，或空状态引导创建。
步骤二：创建 Webhook
- 点击 创建第一个 Webhook 或 创建 Webhook。
- 填写 回调 URL（HTTPS）。
- 勾选订阅的 事件类型（如资源创建、更新、删除等，以列表为准）。
- 若提供 Secret，保存后用于校验请求签名。
- 点击 保存 / 创建。
注意：勿将 Secret 提交到公开仓库；本地调试可用内网穿透，上线后更换正式域名。
预期结果：列表中出现新条目，状态为启用或待测试。
步骤三：测试与维护
- 若提供 测试 / 发送测试事件，触发后检查接收端日志。
- 资源变更时在接收端核对 HTTP 状态码、请求体与幂等处理（按事件 ID 去重）。
- 维护期间可 停用 Webhook，避免失败重试风暴；废弃集成时 删除 条目。
预期结果：订阅事件发生时，接收端稳定收到格式正确的回调。
常见问题
Q：与应用 Webhook 能否共用同一 URL？
A：可以，但请求体事件类型不同，接收端需按
A：可以，但请求体事件类型不同，接收端需按
event 字段分流处理。Q：接收不到回调怎么办？
A：依次检查 HTTPS 可达性、防火墙、事件类型是否勾选、响应是否返回 2xx；与应用 Webhook 排查思路相同，见 Webhooks。
A：依次检查 HTTPS 可达性、防火墙、事件类型是否勾选、响应是否返回 2xx；与应用 Webhook 排查思路相同，见 Webhooks。
Q：资源库 Webhook 会推送哪些字段？
A：通常含资源 id、类型、操作与时间戳等；完整 schema 以 Baklib API 文档为准。
A：通常含资源 id、类型、操作与时间戳等；完整 schema 以 Baklib API 文档为准。