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