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

要求

您的 Webhook 端点必须满足以下要求:
要求详情
HTTPS目标 URL 必须使用 HTTPS
200 响应在 30 秒内返回 200 状态码以确认收到
幂等性处理重复投递 — 参阅 Webhook 处理指南 了解每种事件类型的去重策略

事件类型

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

通用 Payload 字段

每个 Webhook 事件都包含以下基础字段:
字段类型说明
event_typestring事件标识符(state_changemedia_rejectedinvalidate_sr
sr_uuidstring服务请求 UUID
reference_idstring | null您的内部商品 ID(创建服务请求时设置的 external_id
timestampstring事件发生时的 ISO 8601 时间戳

重试机制

投递失败(非 2xx 响应或超时)将通过指数退避策略自动重试:
尝试次数延迟
1立即
2约 5 秒
3约 5 分钟
4约 30 分钟
5约 2 小时
所有重试用尽后,消息将被标记为失败。您可以在 Legitmark 控制台中查看投递状态并手动重试。

测试

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

后续步骤