调用 DescribePrice 查询对应商品的价格信息。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DescribePrice

系统规定参数。取值：DescribePrice。
Commodity String 是 {"components":{"package_version":"yuncode12928000016"},"duration":1,"pricingCycle":"YEAR","productCode":"cmgj01**28","quantity":1,"skuCode":"prepay"}

根据指定的 OrderType，使用对应的配件并序列化。 不同 OrderType 分别对应的 CommodityType 如下所示：

  • INSTANCE_BUY：InstanceBuyCommodity
  • INSTANCE_RENEW：InstanceRenewCommodity
  • INSTANCE_UPGRADE：InstanceUpgradeCommodity

示例中的参数说明如下：

  • productCode：商品 Code。
  • skuCode：商品规格 Code。预付费固定为 prepay，后付费固定为 postpay。
  • components：规格模块。其中版本 package_version 必传，其他模块根据商品的设置来传。
  • duration：周期数量 1,2,3...。
  • pricingCycle: 周期单位。Day（日），Month（月），Year（年）。
OrderType String 是 INSTANCE_BUY

订单类型。取值：

  • INSTANCE_BUY：商品购买
  • INSTANCE_RENEW：实例续费
  • INSTANCE_UPGRADE：实例升级

说明：对于续费类型的询价，需要在 Commodity 中传入 InstanceId。

返回数据

名称 类型 示例值 描述
ProductCode String cmgj01****

商品 Code
OriginalPrice Float 198.0

原价
TradePrice Float 19.8

实际价格
DiscountPrice Float 178.2

优惠的价格（原价-实际价格）
Cuxiao Boolean true

是否有促销
Duration Integer 1

周期数， 1，2，3...
Cycle String MONTH

周期单位

  • DAY：日
  • MONTH：月
  • YEAR：年
InfoTitle String 新年特惠

活动名称
ExpressionCode String ORDER.NO_REAL_NAME_AUTHENTICATION

限购编码
Currency String CNY

币种

  • CNY： 人民币
  • USD： 美元
  • JPY：日元
ExpressionMessage String 企业用户才能购买

限购描述
PromotionRules Array

优惠信息
RuleId String 102112

优惠 ID
Name String 展示型首年19.8元

优惠内容
Title String 展示型首年19.8元

优惠标题
Coupons Array

优惠券信息
CouponOptionCode String ActiveCoupon

优惠券类型
CouponOptionNo String 3874923111

优惠券编号
CouponName String 促销

优惠券名称
CouponDesc String 促销

优惠券描述
CanPromFee Float 100.00

可优惠的价格
IsSelected Boolean false

是否选中

示例

请求示例

https://market.aliyuncs.com/?Action=DescribePrice
&Commodity={"components":{"package_version":"yuncode12928000016"},"duration":1,"pricingCycle":"YEAR","productCode":"cmgj01**28","properties":{},"quantity":1,"skuCode":"prepay"} 
&OrderType=INSTANCE_BUY
&<公共请求参数>

正常返回示例

XML 格式 

<DescribePriceResponse>
  <Cuxiao>false</Cuxiao>
  <Cycle>Month</Cycle>
  <DiscountPrice>0</DiscountPrice>
  <Duration>1</Duration>
  <OriginalPrice>0</OriginalPrice>
  <ProductCode>cmgj01****</ProductCode>
  <TradePrice>0</TradePrice>
</DescribePriceResponse>

JSON 格式 

{
    "Coupons": [],
    "Cuxiao": false,
    "Cycle": "Month",
    "DiscountPrice": 0.0,
    "Duration": 1,
    "OriginalPrice": 0.0,
    "ProductCode": "cmgj01****",
    "PromotionRules": [],
    "TradePrice": 0.0
}

错误码

HttpCode 错误码 错误信息 描述
500 UnknownError An error occurred while processing your request. 未知错误
501 DownstreamError An error occurred while processing your request. 内部调用失败
502 ReturnNull No results found. 没有返回结果
999999 IgnoreError The specified parameter is invalid. 参数错误

访问错误中心查看更多错误码。