任务状态查询
任务状态查询
接口
GET /api/v1/messages/{task_id}
GET 请求没有 JSON 请求体，签名原文中的 CANONICAL_JSON_BODY 为空字符串；路径必须包含实际任务 ID。
状态含义
| 状态 | 说明 |
|---|---|
pending |
已创建，等待队列或定时时间 |
processing |
Worker 正在处理 |
sent |
已提交短信服务商，等待回执 |
success |
投递流程成功 |
failed |
重试/切换后仍失败或被规则终止 |
响应还可能包含 callback_status：pending、delivered、failed、rejected 或 timeout。短信场景中 sent 与 delivered 的语义不同。
轮询建议
使用指数退避而不是高频轮询；达到业务超时后保留任务 ID供后台排查。实时业务优先订阅应用 Webhook，并用查询接口做补偿。