含义
请求已被接受等待处理,但处理尚未完成,响应时还不知道结果。
常见原因
- 任务已加入队列(视频转码、导出、批量导入)
- 异步 webhook 或事件已被接收
- 批处理 API 确认收到请求
解决方法
客户端或访问者
轮询 Location 或响应体中给出的状态 URL,或者等待回调。不要把 202 当作任务成功的证明。
网站或 API 的维护者
返回一个任务资源链接,用于报告进度和最终结果,并说明任务记录保留多久。
响应示例
HTTP/1.1
HTTP/1.1 202 Accepted
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Location: /jobs/7f3a/status
Content-Type: application/json
{
"job": "7f3a",
"state": "queued"
} 规范
常见问题
› 怎么知道 202 的任务什么时候完成?
轮询 API 返回的任务 URL、使用 webhook 或订阅事件。202 响应本身不会改变。
› 返回 202 的请求还会失败吗?
会。服务器只是承诺会去处理;任务之后可能失败,并在状态资源上报告。