用户每次发送接口调用请求，无论成功与否，系统都会向用户返回请求结果。本文将介绍相关返回结果的具体情况。

DMS OpenAPI使用标准的HTTP状态码表示请求处理的结果，具体HTTP状态码如下所示：
  • 返回的HTTP状态码为2xx，代表调用成功。
  • 返回的HTTP状态码为4xx或5xx，代表调用失败。
返回数据的格式主要有XML和JSON两种，默认为XML格式，外部系统可以在请求时指定返回的数据格式。为便于查看，本文档中的返回示例做了格式化处理，实际返回结果是没有进行换行、缩进等处理的。

成功结果

示例：

  • XML示例 
    <RegisterUserResponse>
  <RequestId>ADE24A7C-DB8B-4D32-94AD-E50E3B******</RequestId>
  <Success>true</Success>
</RegisterUserResponse>
  • JSON示例 
    {
    "RequestId":"34E01EDD-6A16-4CF0-9541-C644D1******",
    "Success":true
}

错误结果

调用出错后，HTTP请求会返回一个4xx或5xx的HTTP状态码。返回的消息中包含具体的错误代码及错误信息，还包含一个全局唯一的请求ID（RequestId）和一个本次请求访问的站点ID（HostId）。
说明 您可以根据返回的错误码来定位错误原因，详情请参见错误码。若您无法定位错误原因，请提交工单，并在工单中提供上述HostId和RequestId，便于客服快速解决问题。

示例：

  • XML示例 
    <Error>
  <RequestId>ADE24A7C-DB8B-4D32-94AD-E50E3B******</RequestId>
  <HostId>xxx-xxxxxxxxxx.aliyuncs.com</HostId>
  <Code>UserExisted</Code>
  <Message>The specified user already exists.</Message>
</Error>
  • JSON示例 
    {
    "Code":"UserExisted",
    "HostId":"xxx-xxxxxxxxxx.aliyuncs.com",
    "Message":"The specified user already exists.",
    "RequestId":"34E01EDD-6A16-4CF0-9541-C644D1******"
}