意義
請求已被接受等待處理,但處理尚未完成,回應當下還不知道結果。
常見原因
- 工作已排入佇列(影片轉檔、匯出、大量匯入)
- 非同步 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 的請求還會失敗嗎?
會。伺服器只承諾會嘗試;工作稍後可能失敗,並在狀態資源上回報。