所有回應均包含 HTTP 狀態碼和 (除非狀態碼為 204 (無內容)) 接受標頭。回應內容取決於要求。某些回應包含文件內文,有些僅包含 URL,而有些則為空白。

HTTP 回應代碼

API 用戶端可以在回應中預期看到 HTTP 狀態碼的子集。

表 1. API 傳回的 HTTP 狀態碼
狀態碼 狀態說明
[200 完成] 要求有效且已完成。此回應包含文件內文。
[201 已建立] 要求有效。已建立要求的物件,並且可在位置標頭中指定的 URL 找到。
[202 已接受] 要求有效,且已建立工作以進行處理。此回應通常會與 TaskStatus 元素一起顯示。
[204 無內容] 要求有效且已完成。此回應不包含內文。
[400 要求不正確] 要求內文格式錯誤、不完整或無效。
[401 未經授權] 登入失敗或驗證 Token 已到期。
[403 禁止] 使用者未經驗證,或者沒有足夠的權限可存取要求中指定的一或多個物件。
[404 找不到] 找不到要求中指定的物件。
[405 方法不被允許] 此物件不支援要求中指定的 HTTP 方法。
[406 無法接受] 要求所識別的資源無法產生要求的 Accept 標頭中所指定類型的回應。
[415 不支援的媒體類型] 要求所識別的資源不支援指定之 Content-Type 和 HTTP 方法的要求。
[422 找不到] 通常表示要求 URL 或要求內文格式錯誤。
[429 過多的要求] 用戶端已傳送過多的要求,或者多個用戶端傳送過多同時的要求,且伺服器受到速率限制而無法處理這些要求。

若要解決此問題,請稍後嘗試再次傳送要求。

[500 內部伺服器錯誤] 已收到要求,但因為伺服器上發生內部錯誤而無法完成。
[503 服務無法使用] 伺服器因為發生暫時的情況 (例如資源用盡或伺服器維護),目前無法處理要求。
[504 閘道逾時] 作為閘道或 Proxy 的伺服器未收到來自要求 URL 所指定上游伺服器的及時回應。