HTTP 狀態碼

MC API 會使用標準 HTTP 狀態碼來回應，以指出要求成功或失敗。 除非作業說明中另有說明，否則會套用狀態碼值的下列一般解譯。

表 1. HTTP 狀態碼
HTTP 狀態碼 HTTP 狀態訊息 說明
200 確定 要求已完全成功。 提供包含要求結果的回應內文。
204 無內容 要求已完全成功，且未提供其他回應資訊。
400 錯誤要求 要求遺漏必要的輸入、在提供的輸入中有錯誤，或包含額外的輸入。 錯誤回應內文中提供有關錯誤的其他資訊，其中包括含有其他資訊的原因碼。
403 已禁止 多個錯誤狀況會導致此狀態碼:
  • 要求需要鑑別，但未提供任何 X-API-Session 標頭，或已提供一個標頭，但階段作業 ID 無效。
  • 用來鑑別 API 要求的使用者未獲授權執行所要求的作業。
404 找不到 多個錯誤狀況會導致此狀態碼:
  • URI 不會指定現存資源，或指定 API 使用者沒有物件存取權的資源。
  • URI 指定 MC 不支援的資源或作業，因為它目前是替代 MC。
405 不容許的方法 要求指定的 HTTP 方法對指定的 URI 無效。
409 衝突 受管理資源處於不正確的狀態 (狀態) ，無法執行所要求的作業。 錯誤回應內文中提供有關錯誤的其他資訊，其中包括含有其他資訊的原因碼。
412 已修改資源 前置條件失敗。 如果用戶端提供的 ETag 和伺服器 ETag 相符，則繼續進行 POST。 否則會導致 412 資源修改錯誤。
413 要求內文太大 要求包含的要求內文太大。
415 不受支援的媒體類型 要求的 Content-Type 標頭指定 Web Services API 不支援的表示法。
500 內部伺服器錯誤 處理要求期間發生伺服器錯誤。
501 未實作 要求指定伺服器無法辨識的 HTTP 方法 (適用於任何資源)。
503 無法使用服務 由於某個暫時狀況， MC 無法執行要求。
505 HTTP 版本不受支援 要求指定 Web Services API 不支援的 HTTP 通訊協定版本。