當您使用 HTTP 通訊協定來存取執行 IIS之伺服器上的內容時,伺服器會傳回數值碼,指出要求的結果和回應的性質,包括其成功或失敗。
狀態代碼的第一個數位會將回應類別分類,而最後兩位數則沒有分類用途。 第一個數位可以是五個值之一:
- 1xx (資訊):暫時回應,指出已收到要求並繼續進行處理。
- 2xx (成功):伺服器已成功接收並接受用戶端要求。
- 3xx (重新導向):需要採取更多動作才能完成要求。
- 4xx (用戶端錯誤):發生錯誤源自客戶端瀏覽器且無法完成。
- 5xx (伺服器錯誤):伺服器發生錯誤,要求失敗。
狀態代碼
以下是要求傳回的可能 HTTP 狀態碼。
| 狀態代碼 | 說明 |
|---|---|
| 200 | 成功。 |
| 400 | 其中一個查詢參數遺失或無效。 重試之前,請先更正要求參數。 |
| 401 | 無法驗證要求。 檢查是否已指定認證且有效。 |
| 403 | 要求未獲授權。 檢查詳細數據錯誤訊息。 此狀態代碼通常表示您使用試用版訂用帳戶所提供的所有免費翻譯。 |
| 408 | 因為缺少資源,因此無法完成要求。 檢查詳細數據錯誤訊息。 當要求包含自定義類別時,此狀態代碼通常表示自定義翻譯系統尚無法提供要求。 要求應在等候期間後重試(例如 1 分鐘)。 |
| 429 | 伺服器因為客戶端超過要求限制而拒絕要求。 |
| 500 | 發生未預期的錯誤。 如果錯誤持續發生,請報告失敗的日期和時間、來自響應標頭 X-RequestId 的要求標識碼,以及來自要求標頭 X-ClientTraceId 的用戶端識別符。 |
| 503 | 伺服器暫時無法使用。 請重試。 如果錯誤持續發生,請報告失敗的日期和時間、來自響應標頭 X-RequestId 的要求標識碼,以及來自要求標頭 X-ClientTraceId 的用戶端識別符。 |
如果發生錯誤,要求會傳回 JSON 錯誤回應。 錯誤碼是6位數的數字,結合3位數 HTTP狀態代碼,後面接著3位數的數位,以進一步分類錯誤:
錯誤碼
標準錯誤回應是 JSON 物件,名稱/值群組名稱為 error。 此值也是具有屬性的 JSON 物件:
-
code:伺服器定義的錯誤碼。 -
message:字串,提供人類看得懂的錯誤表示法。
例如,一旦免費配額用盡,具有免費試用訂用帳戶的客戶會收到下列錯誤:
{
"error": {
"code":403001,
"message":"The operation isn't allowed because the subscription has exceeded its free quota."
}
}
錯誤碼是6位數的數字,結合3位數 HTTP狀態代碼,後面接著3位數的數位,以進一步分類錯誤。 常見的錯誤碼包括:
| Code | 說明 |
|---|---|
| 400000 | 其中一個要求輸入無效。 |
| 400001 | "scope" 參數無效。 |
| 400002 | "category" 參數無效。 |
| 400003 | 語言指定名稱遺漏或無效。 |
| 400004 | 目標指令碼指定名稱 ("To script") 遺漏或無效。 |
| 400005 | 輸入文字遺漏或無效。 |
| 400006 | 語言與指令碼的組合無效。 |
| 400018 | 來源指令碼指定名稱 ("From script") 遺漏或無效。 |
| 400019 | 不支援其中一個指定的語言。 |
| 400020 | 輸入文字陣列中的其中一個元素無效。 |
| 400021 | API 版本參數遺漏或無效。 |
| 400023 | 其中一個指定的語言組無效。 |
| 400035 | 來源語言 ("From" 欄位) 無效。 |
| 400036 | 目標語言 ("To" 欄位) 無效。 |
| 400042 | 其中一個指定的選項 ("Options" 欄位) 無效。 |
| 400043 | 用戶端追蹤標識碼 (ClientTraceId 欄位或 X-ClientTraceId 標頭) 遺失或無效。 |
| 400050 | 輸入文字太長。 檢視要求限制。 |
| 400064 | "translation" 參數遺漏或無效。 |
| 400070 | 目標指令碼 (ToScript 參數) 數目與目標語言 (To 參數) 數目不符。 |
| 400071 | 此值對 TextType 無效。 |
| 400072 | 輸入文字陣列的元素太多。 |
| 400073 | 指令碼參數無效。 |
| 400074 | 要求的本文不是有效的 JSON。 |
| 400075 | 語言組與類別組合無效。 |
| 400077 | 超過要求大小上限。 檢視要求限制。 |
| 400079 | 所要求用來在來源與目標語言之間進行翻譯的自訂系統不存在。 |
| 400080 | 語言或指令碼不支援轉換。 |
| 401000 | 要求未獲得授權,因為認證遺失或無效。 |
| 401015 | 「提供的認證適用於語音 API。 此要求需要文字 API 的認證。 使用翻譯工具的訂用帳戶。 |
| 403000 | 不允許此作業。 |
| 403001 | 不允許此作業,因為訂用帳戶超過其免費配額。 |
| 405000 | 要求的資源不支援要求方法。 |
| 408001 | 正在準備要求的翻譯系統。 請在數分鐘後重試。 |
| 408002 | 等待傳入的串流時要求逾時。 用戶端未在伺服器準備好等待的時間內產生要求。 用戶端可能會在稍後不需要修改的情況下重複要求。 |
| 415000 | Content-Type 標頭遺失或無效。 |
| 429000, 429001, 429002 | 伺服器因為客戶端超過要求限制而拒絕要求。 |
| 500000 | 發生未預期的錯誤。 如果錯誤持續發生,請報告錯誤日期/時間、響應標頭 X-RequestId 的要求識別碼,以及來自要求標頭 X-ClientTraceId 的用戶端識別碼。 |
| 503000 | 服務暫時無法使用。 重試。 如果錯誤持續發生,請報告錯誤日期/時間、響應標頭 X-RequestId 的要求識別碼,以及來自要求標頭 X-ClientTraceId 的用戶端識別碼。 |