Open Platform
开放平台 - 统计回调(Webhook)
Connect 回调事件格式与接入建议
开放平台 - 统计回调(Webhook)
Webhook 用于回传配置行为结果,帮助你统计接入效果。
回调时机
常见状态:
success:用户确认并配置成功cancelled:用户取消error:执行失败
请求示例
POST https://your-domain.com/lime/callback
Content-Type: application/json
{
"event": "connect",
"status": "success",
"relay_id": "your-relay",
"ref": "campaign-2026",
"timestamp": "2026-02-16T10:00:00Z"
}
字段建议
event:事件类型status:状态值relay_id:服务方标识ref:渠道标记timestamp:事件时间
安全建议
- 仅接受 HTTPS 回调
- 校验来源与参数完整性
- 对回调做幂等处理
- 记录失败重试日志
监控建议
- 统计成功率与取消率
- 跟踪错误类型占比
- 区分渠道来源效果