Skip to main content
Legitmark 通过 Webhook 向您的 HTTPS 端点发送实时事件通知。当服务请求状态变更、图片在质量审核中被拒绝或请求被作废时,您的端点将收到包含事件数据的 POST 请求。 消息投递支持自动重试和指数退避。
需要设置 Webhook 目标地址?请按照入门指南中的步骤操作。

要求

您的 Webhook 端点必须满足以下要求:

事件类型

所有目标地址自动接收全部事件类型,不支持按事件过滤。

state_change

服务请求状态变更 — 质量审核、鉴定进度或最终结果。

media_rejected

上传的图片在质量审核中被拒绝。

invalidate_sr

服务请求被取消或无法处理。

通用 Payload 字段

每个 Webhook 事件都包含以下基础字段:

重试机制

投递失败(非 2xx 响应或超时)将通过指数退避策略自动重试: 所有重试用尽后,消息将被标记为失败。您可以在 Legitmark 控制台中查看投递状态并手动重试。

测试

如果您还没有准备好端点,可以使用 Svix Play 生成一个临时的 Webhook URL 用于测试。将生成的 URL 作为 Webhook 目标地址粘贴到开发者设置中,发送测试事件,然后实时查看 Payload。

后续步骤

事件类型

每种事件类型的详细 Payload 结构。

Webhook 处理指南

代码示例、最佳实践和安全指南。