全局錯誤碼說明
錯誤碼返回格式
對于 API 調用有兩類返回結果,失敗或成功。
調用成功:
{ "error_code":0, "error_msg":"調用成功", "data":xxx }
調用失敗:
{ "error_code":402, "error_msg":"參數 op_user 不能為空" }
可以看出 error_code
為標識調用成功與否的重要返回值,當 error_code
值為 0 時說明調用成功(在返回結果中同時還包括有其他業務數據字段),而當 error_code
值大于 0 的時候則說明調用失敗,同時 error_msg
會對錯誤進行描述,便于獲知具體失敗原因。
全局錯誤碼
錯誤碼 | 錯誤說明 | 解決方案 |
---|---|---|
400 | 業務失敗 | 檢查 API 請求參數 |
401 | 參數(格式)無效 | 檢查傳入參數是否有誤,例如要求為數字的字段傳入了日期值 |
402 | 參數不能為空 | 檢查是否已經傳入了所有要求為非空的參數 |
403 | 不被支持的操作 | 指定 API 可能未被開放,或沒有此 API 調用權限 |
410 | 權限不足 | 確認操作用戶(op_user)對指定記錄是否有相應的權限 |
490 | 未開通 OpenAPI | 聯系服務人員開通 OpenAPI 模塊 |
491 | 請求超限 | 超出 OpenAPI 所允許的最大調用頻率/次數,請優化功能減少 API 調用,或聯系服務人員增加 API 調用次數 |
500 | 系統錯誤 | 請聯系服務人員 |