Legitmark 发送三种事件类型。每个 Webhook 目标地址自动接收所有事件。
state_change
当服务请求转换到新状态时发送。这是跟踪鉴定进度和结果的主要事件。
Payload
您的内部商品 ID — 创建服务请求时设置的 external_id。
状态转换
下表列出了您应该处理的最常见状态转换：
最重要的状态转换是 COMPLETE + APPROVED 或 COMPLETE + REJECTED — 这是最终鉴定结果。参阅服务请求状态了解完整的状态机。使用 TypeScript SDK（v0.2.0+），您可以使用 isAuthentic(event) 和 isCounterfeit(event) 来检查这些状态，而无需手动比较字符串。参阅 Webhook 处理指南。
当上传的图片未通过质量审核时发送。每张被拒绝的图片都包含面的 UUID 和拒绝原因。上传替换照片时使用该 UUID。
Payload
被拒绝图片及原因的数组。
面的 UUID。与 Get SR 返回的面 UUID 相同，上传替换照片时传入该值。
拒绝原因。这些是来自 Legitmark 原因数据库的人类可读字符串（例如 "图像模糊"、"光线不足"）。随着新原因的添加，值可能会变化。
收到 media_rejected 时，服务请求处于 QC / REJECTED。为 sides 中的每一项上传新照片，将 side 作为面的 UUID，然后调用 POST /api/v2/sr/{sr_uuid}/resubmit。该调用会把请求移回 QC / PENDING。POST /submit 仅在服务请求为 DRAFT 时可用。在 QC / REJECTED 下调用会返回 400，消息为 Cannot submit: Service request is not in DRAFT state。 使用 TypeScript SDK，needsResubmission(event) 对此事件类型返回 true。参阅 Webhook 处理指南。
invalidate_sr
当服务请求被取消时发送。
Payload
显示 invalidation_reason 属性
原因代码。目前固定为 "CANCELLED"。未来可能会增加其他代码。
具体的取消原因。常见值包括：
"Unsupported Product or SKU"（不支持的产品或SKU）"Unsupported Channel"（不支持的渠道）"Service Request Inactivity"（服务请求不活跃）"Duplicate Service Request"（重复的服务请求）"Insufficient Product Information"（产品信息不足）"Customer Requested Cancellation"（客户请求取消）"Poor Image Quality or Unusable Media"（图像质量差或不可用的媒体）
也可能出现自定义的文本原因。 
