错误处理
错误处理
当调用 API 发生错误时,响应中包含的 result 字段会指明错误码(result.resultCode
)和错误信息(result.resultMessage
)。您可以根据下面的错误码章节排查故障问题,如果错误仍然存在,您也可以联系 ZOLOZ 技术支持寻求帮助。
错误码
ZOLOZ 返回两类错误码:
- 通用错误码:适用于所有 API,用于标识 API 请求的调用状态。
- API 特有结果码:适用于特定的 API,用于标识特定 API 的详细处理结果。
通用错误码
下表展示了通用错误码的相关信息,如果您在调用 API 时获得的结果码不在下表中,请参考 API特有结果码 章节。
常见错误码的信息见下表。如果您在此表中未找到调用 API 时返回的错误码,请参考特定 API 特有结果码 部分。
结果码 | 结果状态 | 结果信息 |
SUCCESS | S | 请求成功。 |
PARAM_MISSING | F | 请求失败,参数丢失。 |
PARAM_ILLEGAL | F | 请求失败,参数不合法。 |
MSG_PARSE_ERROR | F | 请求失败,信息格式不合法。 |
SIGNATURE_INVALID | F | 未经授权,签名无效。 |
KEY_NOT_FOUND | F | 未找到密钥。未经授权ZOLOZ服务器找不到密钥。 |
OAUTH_FAIL | F | 未经授权,OAuth 2.0授权失败。 |
NO_INTERFACE_DEF | F | 请求API未定义。 |
REQUEST_TRAFFIC_EXCEED_LIMIT | F | 请求量超过限制。 |
SYSTEM_ERROR | U | 产生系统错误。 |
PROCESS_TIMEOUT | F | API请求超时。 |
MERCHANT_NOT_FOUND | F | 找不到商户。 |
API 特有结果码
关于适用于特定 API 的错误码,请参见每个 API 中的 API 特有结果码 部分。