全部产品

云市场商品询价接口

更新时间:2018-12-04 15:45:43

描述

云市场商品询价接口

目前支持新购、续费和升级操作的询价,返回操作对应的价格信息。

请注意示例中部分符号为全角,实际请求时应全部使用半角符号。

请求参数

参数 类型 是否必选 示例值 描述
Action String DescribePrice
Commodity String {{“components”:{“package_version”:”yuncode12928000016”},”duration”:1,”pricingCycle”:”YEAR”,”productCode”:”cmgj018928”,”properties”:{},”quantity”:1,”skuCode”:”prepay”}
可根据指定的 OrderType,使用对应的配件并序列化。 不同 OrderType 分别对应的 CommodityType 如下所示:
  • INSTANCE_BUY:InstanceBuyCommodity
  • INSTANCE_RENEW:InstanceRenewCommodity
  • INSTANCE_UPGRADE:InstanceUpgradeCommodity
  • INSTANCE_DOWNGRADE:InstanceDowngradeCommodity
  • INSTANCE_EXPAND:InstanceExpandCommodity

商品模型示例:

  1. {"components":{"package_version":"yuncode12928000016"},"duration":1,"pricingCycle":"YEAR","productCode":"cmgj018928","properties":{},"quantity":1,"skuCode":"prepay"}>{"components":{"package_version":"yuncode12928000016"},"duration":1,"pricingCycle":"YEAR","productCode":"cmgj018928","properties":{},"quantity":1,"skuCode":"prepay"}

新的商品模型,skuCode 预付费固定为prepay 后付费固定为postpay另外需要传入components 其中版本package_version 必传,其他模块根据商品的设置来传

注:询价时,duration和pricingCycle需要与ecs询价接口的数据保持 一致

OrderType String INSTANCE_BUY

订单类型

可选值:

  • INSTANCE_BUY,商品购买
  • INSTANCE_RENEW,实例续费
  • INSTANCE_UPGRADE,实例升级(后续支持)
  • INSTANCE_DOWNGRADE,实例降配(后续支持)
  • INSTANCE_EXPAND,实例扩容 (后续支持)

对于Renew类型的询价,需要在Commodity中传入InstanceId

返回参数

参数 类型 示例值 描述
ProductCode String cmgj018928

商品code

OriginalPrice Float 198.0

原价

TradePrice Float 19.8

实际价格

DiscountPrice Float 178.2

优惠的价格(原价-实际价格)

PromotionRules

优惠信息

  └RuleId String 102112

优惠id

  └Name String 展示型首年19.8元

优惠内容

  └Title String 展示型首年19.8元

优惠标题

示例

请求示例

  1. /?Action=DescribePrice&Commodity={"components":{"package_version":"yuncode12928000016"},"duration":1,"pricingCycle":"YEAR","productCode":"cmgj018928","properties":{},"quantity":1,"skuCode":"prepay"}
  2. &OrderType=INSTANCE_BUY
  3. &<公共请求参数>

正常返回示例

XML 格式

  1. <DescribePriceResponse>
  2. <DiscountPrice>0.0</DiscountPrice>
  3. <ProductCode>cmfw019940</ProductCode>
  4. <OriginalPrice>300.0</OriginalPrice>
  5. <TradePrice>300.0</TradePrice>
  6. <PromotionRules/>
  7. </DescribePriceResponse>

JSON 格式

  1. {
  2. "DiscountPrice":0.0,
  3. "OriginalPrice":300.0,
  4. "ProductCode":"cmfw019940",
  5. "PromotionRules":{
  6. "PromotionRule":[]
  7. },
  8. "TradePrice":300.0
  9. }

异常返回示例

XML 格式

  1. <Error>
  2. <RequestId>DE134F78-831E-49BB-A9BE-DB216D7B5115</RequestId>
  3. <HostId>market.aliyuncs.com</HostId>
  4. <Code>UnknownError</Code>
  5. <Message>The request processing has failed due to some unknown error.</Message>
  6. </Error>

JSON 格式

  1. {
  2. "Code":"UnknownError",
  3. "HostId":"market.aliyuncs.com",
  4. "Message":"The request processing has failed due to some unknown error.",
  5. "RequestId":"B55A3554-8C06-4AFF-B930-D7636758ED14"
  6. }