所有回應均包含 HTTP 狀態碼和 (除非狀態碼為 204 (無內容)) 接受標頭。回應內容取決於要求。某些回應包含文件內文,有些僅包含 URL,而有些則為空白。
HTTP 回應代碼
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 所指定上游伺服器的及時回應。 |