API 返回结果的格式统一。header 中返回 2xx HTTP 状态码代表接口调用成功；header 中返回 4xx 或 5xx HTTP 状态码代表接口调用失败。调用失败时，部分接口会同时在 body 中返回该调用的相关错误信息供您排查问题。

正常返回示例

接口调用成功后会返回接口返回参数，这样的返回为正常返回。正常返回的 HTTP header 中的状态码为 2xx。

正常返回示例如下：

{ 
    "code": 200,         
    "cid": 12345        
}

异常返回示例

接口调用出错后，会返回错误码、错误信息，这样的返回为异常返回。HTTP header 中的状态码为 4xx 或者 5xx。部分接口会在 body 中返回具体的业务错误码和错误信息供您排查问题。

您可以根据接口调用后返回的错误码，参考 header 中的 HTTP 状态码或业务错误码排查错误。当您无法排查错误时，可以提交工单联系技术支持人员。

异常返回示例如下：

• header 中返回状态码，且 body 中返回错误码（code）：

  请参考 header 中的 HTTP 状态码和业务错误码排查问题。

  { 
      "code": 400,       
      "errmsg": invalid params        
  }
  

• 仅在 header 中返回状态码：

  请参考 header 中的 HTTP 状态码排查问题。

header 中的 HTTP 状态码