功能介绍:续费实例时费用查询
POST https://[endpoint].ctapi.ctyun.cn/v1/spuInst/describePrice/renewInst
Content-Type:application/json
请求体参数说明:
参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
---|---|---|---|---|
packageType | 2 | String | 否 | 套餐类型,取值范围:2包年型套餐活动1 校园优惠活动-1 没有套餐活动 |
id | 1a4914183af445669d0b7bff28ef9a43 | String | 否 | 订单Id,该参数可指定订单Id,不传则使用云平台生成的订单号 |
isPlatformSpecificResource | false | boolean | 否 | 是否特定平台,取值范围:true 或false 为true表示是特定平台资源,省公司通过API开通的资源以及资源后续的续订、升级订单只能在省公司crm操作,不能在ctyun系统或者省门户系统 进行订单操作(如升级、续订、退订等等功能)。传false 表示省公司通过API开通的资源后续可以在其他平台进行订单操作,如(升级、续订、退订)不传该属性时,默认为false 不是特定平台) |
billingOwner | 1 | String | 否 | 出账方 取值范围 1 和 2为1表示云公司出账 为2表示省公司出账 默认为1 (云公司出账)续订、升级、退订都是直接继承新购时传的出账方字段值 |
isPackage | true | boolean | 否 | 是否融合套餐 取值范围 true 或 false 为true 表示是融合套餐 为false表示不是融合套餐 默认为false |
chargeOffType | 1 | String | 否 | 出账类型 取值范围 :1 一次性出账 2 按月 (普通订单只能选择一次性或按月,默认按月出账 ,包年的订单一定是一次性,根据计费反馈,包年订单一次性有优惠) |
autoPay | false | boolean | 否 | 是否自动支付 取值范围:true 或 false true是自动支付(不需要再单独调用户订单确认接口) false 不是自动支付(需要单独调用用户订单确认接口) 不传默认为false |
cycleCount | 2 | String | 是 | 续订周期数量 2表示续订2个月(值需大于零,不超过384个月) |
cycleType | 3 | String | 是 | 3表示按月订购,5表示按一年订购,6表示按两年订购、7表示按三年订购。cycleCnt属性为1,cycleType取值为3 表示订购1个月 |
resourceIds | Array | 是 | 主虚拟资源ID(批量续订时资源不能超过10个)通过查询资源详细信息接口获取masterResourceId字段 |
返回参数说明:
参数名 | 示例值 | 参数类型 | 参数描述 |
---|---|---|---|
message | success | String | 响应信息 |
statusCode | 800 | int | 响应状态码 |
returnObj | Object | 返回对象 | |
isSucceed | true | boolean | 是否成功 |
totalPrice | 3200.0 | String | 总价 |
finalPrice | 3200.0 | String | 最终价格 |
verifyStatusCode | 800 | ||
subOrderPrices | Object | 返回对象 | |
serviceTag | PAAS | String | |
orderItemPrices | Object | 订单项价格 | |
itemId | 646955254ed949dcb48932fd9641c1e6 | String | 订单项ID |
resourceType | DCS | String | 资源类型 |
请求示例:
POST https://[endpoint].ctapi.ctyun.cn/v1/spuInst/describePrice/renewInst
{
"packageType":"2",
"isPlatformSpecificResource":true,
"billingOwner":"2",
"isPackage":false,
"chargeOffType":"2",
"autoPay":true,
"cycleCount":"2",
"cycleType":"3",
"resourceIds":[
"b8d6625d63e045e790af8ccfa573d955"
]
}
返回示例:
{
"statusCode": 800,
"message": null,
"returnObj": [
{
"isSucceed": true,
"totalPrice": "3000.0",
"finalPrice": "3000.0",
"subOrderPrices": [
{
"totalPrice": "3000.0",
"finalPrice": "3000.0",
"serviceTag": "PAAS",
"orderItemPrices": [
{
"itemId": "eba2938f104045ff9d806a8ad2c32b60",
"resourceType": "DCS",
"totalPrice": "3000.0",
"finalPrice": "3000.0"
}
]
}
],
"verifyStatusCode": null
}
]
}