響應類型

HTTP狀態碼

場景

正常

200

后端服務順利返回，沒有出現異常，或者即使有異常，也符合預期。注意，業務失敗不允許用200返回，請使用400錯誤碼。

后端服務異常

500

后端服務返回：Internal Error。錯誤碼沒有映射到，返回默認錯誤碼。

服務端無法完成請求

501

服務器不支持請求的功能，無法完成請求。

服務不可用

503

網關調用后端服務失敗，后端服務不可用。

入參缺失

400

必傳參數缺失。有些可選參數在特定業務場景下缺失。

入參非法

400

參數格式不正確，比如：日期、數字、大小寫不正確，長度問題等造成的。特定業務參數校驗失敗，比如參數內容不符合接口要求、或者JSON和RepeatList格式的入參，不滿足接口要求。 * 增加URL、域名、字符串格式合法性校驗。

賬戶驗證失敗

400

賬戶欠費。余額不足。 * 風控問題。業務失敗的錯誤碼統一使用400。

無權操作

403

RAM校驗不通過訪問控制。用戶無權執行此操作。

越權操作

403

資源鑒權不通過（資源存在并歸屬于其他賬號，不存在的參考資源不存在）。

SQL錯誤

403

【強制】產品內部系統的SQL錯誤不應透出給用戶，應使用 500 錯誤。SQL語法錯誤。 * SQL超時錯誤。

流控

429

系統流控：超過了系整體流控的閾值。用戶流控：單位時間內單個用戶訪問次數達到了上線。業務規則流控：用戶調用超過了業務方規則限制。IP流控。

資源不存在

404

獲取單個資源信息時，若不存在。刪除時若資源已不存在提示404。如：InvalidInstanceId.NotFound