错误处理

错误处理

当调用 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 特有结果码 部分。