QueryPriceForSubscription - 预付费询价--费用中心-火山引擎

文档中心

立即注册

导航

QueryPriceForSubscription - 预付费询价

最近更新时间：2025.06.26 20:58:44首次发布时间：2025.03.11 13:08:33

预付费询价

使用说明

此接口仅支持预付费规格进行新购场景询价。
均是使用商品最新价格进行询价。
单次请求规格组ConfigList最多支持50个。

注意事项

单账号QPS上限为10。
子用户使用该接口时，应具备BillingCenterFullAccess或BillingCenterReadOnlyAccess权限策略。

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

参数	类型	是否必填	示例值	描述
Action	String	是	QueryPriceForSubscription	要执行的操作，取值：QueryPriceForSubscription。
Version	String	是	2022-01-01	API的版本，取值：2022-01-01。
Product	String	是	Product_1	商品code
ConfigList	Array of Object	是	[ { "ConfigurationCode": "ConfigurationCode_1", "Quantity": 2, "ChargeItemCode": "ChargeItemCode_1", "UseDuration": 1, "Count": 1 } ]	规格列表,单次最大20组

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数	类型	示例值	描述
Currency	String	CNY	币种,CNY
TotalOriginalAmount	String	100	总刊例价(小数点后6位)
TotalDiscountAmount	String	50	总折扣价(小数点后6位)
ConfigList	Array of Object	[ { "ConfigurationCode": "ConfigurationCode_1", "ChargeItemCode": "ChargeItemCode_1", "OriginalAmount": "100", "DiscountAmount": "50", "Quantity": 2, "Price": "50", "DiscountDetail": { "DiscountType": "fixed_price", "DiscountPrice": "25" } } ]	规格列表

请求示例

POST /?Action=QueryPriceForSubscription&Version=2022-01-01 HTTP/1.1
Host: billing.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20250224T061543Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20250224/cn-beijing/billing/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

{
  "Product": "Product_1",
  "ConfigList": [
    {
      "ConfigurationCode": "ConfigurationCode_1",
      "ChargeItemCode": "ChargeItemCode_1",
      "Quantity": 2,
      "UseDuration": 1,
      "Count": "1"
    }
  ]
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20250224142018066115206120706C0B",
    "Action": "QueryPriceForSubscription",
    "Version": "2022-01-01",
    "Service": "billing",
    "Region": "cn-beijing"
  },
  "Result": {
    "CalSerialNo": "CSN_1234567890",
    "Currency": "CNY",
    "TotalOriginalAmount": "100",
    "TotalDiscountAmount": "50",
    "ConfigList": [
      {
        "ConfigurationCode": "ConfigurationCode_1",
        "ChargeItemCode": "ChargeItemCode_1",
        "OriginalAmount": "100",
        "DiscountAmount": "50",
        "Quantity": 2,
        "Price": "50",
        "DiscountDetail": {
            "DiscountType": "fixed_price",
            "DiscountPrice": "25"
        }
      }
    ]
  }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	MissingParameter	The request is missing %s parameter.	参数缺失
400	InvalidParam	The parameter %s is invalid.	参数无效
400	OperationDenied.ConfigurationNotAllowed	The configuration %s is not allowed	该配置不被允许询价,制定价格等情况
400	OperationDenied.ConfigurationNotPublic	The configuration %s is not public	该配置非公开售卖
400	OperationDenied.ConfigurationNotOnline	The configuration %s is not online	该配置非上架售卖
400	OperationDenied.ChargeItemNotPublic	The chargeItem %s is not public	该计费项非公开售卖
400	OperationDenied.ChargeItemNotOnline	The chargeItem %s is not online	该计费项非上架售卖
403	RequestReject	You have engaged in unauthorized operations, and the function is temporarily unavailable.	您涉及违规操作，暂时无法使用该功能
500	InternalError	Service has some internal Error. Pls Contact With Admin.	服务内部异常