全部产品
云市场

云市场商品询价接口

更新时间:2019-10-20 20:50:28

描述

云市场商品询价接口

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

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

请求参数

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

商品模型示例:

  1. {"components":{"package_version":"yuncode544300000"},"duration":1,"pricingCycle":"Month","productCode":"cmgj011443","properties":{},"quantity":1,"queryPromotion":false,"skuCode":"cmgj011443-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

返回参数

youhu youhu
参数 类型 示例值 描述
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元

优惠标题

ExpressionCode String 阿里云认证企业用户才可购买

限购规则

Currency String

币种

Coupons String

优惠卷

  └CouponOptionCode String

已知优惠类型

  └CouponOptionNo String

可选择的优惠号

  └CouponName String 满减

优惠name

  └CouponDesc String 满200.0 减2.0

优惠描述

  └CanPromFeeFloat

可以优惠的价格

  └IsSelectedBoolean false

是否外部选中

示例

请求示例

  1. /?Action=DescribePrice&Commodity={"components":{"package_version":"yuncode544300000"},"duration":1,"pricingCycle":"Month","productCode":"cmgj011443","properties":{},"quantity":1,"queryPromotion":false,"skuCode":"cmgj011443-prepay"}&OrderType=INSTANCE_BUY
  2. &<公共请求参数>

正常返回示例

JSON 格式

  1. {
  2. "coupons": [],
  3. "cuxiao": false,
  4. "cycle": "Month",
  5. "discountPrice": 0.0,
  6. "duration": 1,
  7. "originalPrice": 0.0,
  8. "productCode": "cmgj011443",
  9. "promotionRules": [],
  10. "tradePrice": 0.0
  11. }

异常返回示例

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. }