DevToolPal
繁
2xx 成功

202 Accepted

已接受

意義

請求已被接受等待處理,但處理尚未完成,回應當下還不知道結果。

常見原因

  • 工作已排入佇列(影片轉檔、匯出、大量匯入)
  • 非同步 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"
}

規範

RFC 9110 §15.3.3

常見問題

› 怎麼知道 202 的工作何時完成?

輪詢 API 回傳的工作 URL、使用 webhook 或訂閱事件。202 回應本身不會改變。

› 回傳 202 的請求還會失敗嗎?

會。伺服器只承諾會嘗試;工作稍後可能失敗,並在狀態資源上回報。