调用 API 服务后返回数据采用统一格式,本文为您提供返回成功结果和错误结果的示例。
数据格式
返回的 HTTP 状态码为 2xx,代表调用成功。 返回的 HTTP 状态码为 4xx 或 5xx,代表调用失败。 调用成功返回的数据格式主要有 XML 和 JSON 两种,外部系统可以在请求时传入参数来制定返回的数据格式,默认为 XML 格式。
本文档中的返回示例为了便于用户查看,做了格式化处理,实际返回结果是没有进行换行、缩进等处理的。
成功结果
- XML 示例
<DescribePriceResponse> <DiscountPrice>0.0</DiscountPrice> <ProductCode>cmfw019940</ProductCode> <OriginalPrice>300.0</OriginalPrice> <TradePrice>300.0</TradePrice> <PromotionRules/> </DescribePriceResponse>
- JSON 示例
{ "DiscountPrice":0.0, "OriginalPrice":300.0, "ProductCode":"cmfw019940", "PromotionRules":{ "PromotionRule":[] }, "TradePrice":300.0 }
错误结果
调用接口出错后,将不会返回结果数据。调用方可根据每个接口对应的错误码以及公共错误码来定位错误原因。公共错误码的详细信息请参见公共错误码表。
当调用出错时,HTTP 请求返回一个 4xx 或 5xx 的 HTTP 状态码。返回的消息体中包括具体的错误代码及错误信息。另外还包含一个全局唯一的请求 ID(RequestId) 和一个您该次请求访问的站点 ID(HostId)。在调用方找不到错误原因时,可以联系阿里云客服,并提供该 HostId 和 RequestId,以便我们尽快帮您解决问题。
- XML 示例
<Error> <RequestId>DE134F78-831E-49BB-A9BE-DB216D7B5115</RequestId> <HostId>market.aliyuncs.com</HostId> <Code>UnknownError</Code> <Message>The request processing has failed due to some unknown error.</Message> </Error>
- JSON 示例
{ "Code":"UnknownError", "HostId":"market.aliyuncs.com", "Message":"The request processing has failed due to some unknown error.", "RequestId":"B55A3554-8C06-4AFF-B930-D7636758ED14" }