发布结果回传日志回调
发布结果结果回传日志回调:每篇文章每个账号都可追踪
颜小二在每个发布任务进入终态时通过结果回传地址回调你的系统:成功回传 published_url,失败回传 error_code 和 error_message。
典型痛点:发布结果不透明;只知道"已提交"不知道是否成功;失败原因丢失。
- 发布回调URL
- published_url回传
- 发布结果接口
回调事件类型
publish.success(发布成功)、publish.failed(发布失败)、account.login_expired(账号失效)、agent.offline(Agent 离线)。
回调签名校验
HTTP Header 附带 X-Yan-Signature,按 HMAC-SHA256(secret, raw_body) 计算。请在服务端校验签名后再处理事件。
回调失败重试
结果回传地址不可达或返回非 2xx 时进入延迟队列重试,避免临时网络抖动丢失事件。
对账接口补救
极端情况下可通过 GET /v1/tasks/{task_id} 主动补查任务状态,与结果回传日志互为对账。