调用API服务后返回结果主要有XML和JSON两种格式,默认为JSON,您可以指定公共请求参数Format变更返回结果的格式。

说明 本文档中的返回示例为了便于用户查看,做了格式化处理,实际返回结果可能未进行换行、缩进等处理。

正常返回示例

接口调用成功后会返回接口返回参数和请求ID,此类返回为正常返回。HTTP状态码为2xx。

  • XML格式
    <RequestId>7F7D235C-76FF-4B65-800C-8238AE3F7230</RequestId>
    <!--返回结果数据-->                   
  • JSON格式
    {
        "RequestId": "7F7D235C-76FF-4B65-800C-8238AE3F7230",
        /* 返回结果数据 */
    }            

异常返回示例

接口调用出错后,会返回错误码、错误信息和请求ID,此类返回为异常返回。HTTP状态码为4xx或者5xx。

您可以根据接口错误码和公共错误码来定位错误原因。更多信息,请参见错误处理

当错误无法排除时,您可以提交工单联系我们,并在工单中注明该次请求访问的服务节点HostId和请求的唯一标识RequestId。