带宽续费下单
更新时间 2025-10-17 14:30:17
最近更新时间: 2025-10-17 14:30:17
接口功能介绍
实例费用接口-带宽续费下单
接口约束
无
URI
POST /v1/spuInst/renewAdditionalBandwidth
路径参数 无
Query参数 无
请求参数
请求头header参数 无
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| packageType | 否 | String | 套餐类型，取值范围： | ||
| 2 包年型套餐活动 | |||||
| 1 校园优惠活动id | |||||
| -1 没有套餐活动 | 2 | ||||
| id | 否 | String | 订单Id，该参数可指定订单Id，不传则使用云平台生成的订单号 | 1a4914183af445669d0b7bff28ef9a43 | |
| sellingPrice | 否 | Boolean | 最终售价，所填价格不能低于原价的5.5折。如果是省内出账，该参数必须填，如果是云公司出账，该参数为非必填，不填的情况下就是按默认折扣批价 ，填了则以最终销售价格为准，取值不能低于原价的5.5折 没填如该客户有默认优惠返回金额则以默认优惠为准 没填也没设置默认优惠则以原价为准 | false | |
| isPlatformSpecificResource | 否 | Boolean | 是否特定平台，取值范围：true 或false 为true表示是特定平台资源，省公司通过API开通的资源以及资源后续的续订、升级订单只能在省公司crm操作，不能在ctyun系统或者省门户系统 进行订单操作（如升级、续订、退订等等功能）。传false 表示省公司通过API开通的资源后续可以在其他平台进行订单操作，如（升级、续订、退订）不传该属性时，默认为false 不是特定平台） | false | |
| billingOwner | 否 | Integer | 出账方 取值范围 1 和 2 | ||
| 为1表示云公司出账 为2表示省公司出账 默认为1 （云公司出账）续订、升级、退订都是直接继承新购时传的出账方字段值 | 1 | ||||
| isPackage | 否 | Boolean | 是否融合套餐 取值范围 true 或 false 为true 表示是融合套餐 为false表示不是融合套餐 默认为false（现不管是否省内套餐，最终售价（sellingPrice 参数）都不能低于5.5折；） | true | |
| chargeOffType | 否 | Integer | 出账方 取值范围 1 和 2 br /为1表示云公司出账 为2表示省公司出账 默认为1 （云公司出账）续订、升级、退订都是直接继承新购时传的出账方字段值 | 1 | |
| paymentPlanInitialMonth | 否 | String | 出账月份 可以自行指定出账月份，如当前月为4月，可以指定为当前月出账或5月（次月）进行出账，传值必须为时间戳（如20180409的时间戳为1523265578713） | 1523265578713 | |
| autoPay | 否 | Boolean | 是否自动支付 取值范围：true 或 false true是自动支付（不需要再单独调用户订单确认接口） false 不是自动支付（需要单独调用用户订单确认接口） 不传默认为false | true | |
| cycleCount | 是 | Integer | 续订周期数量 2表示续订2个月（值需大于零，不超过384个月） | 2 | |
| cycleType | 是 | Integer | 订购周期类型，取值范围：3表示按月订购，5表示按一年订购，6表示按两年订购、7表示按三年订购，cycleCnt属性为1，cycleType取值为3 表示订购1个月 | 3 | |
| resourceIds | 是 | Array of Strings | 主虚拟资源ID（批量续订时资源不能超过10个） | ||
| 通过查询资源详细信息接口获取masterResourceId字段 | ["3ea8c148f1bb46a9bde07dd7234a00d1"] |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 返回码 | ||
| 取值范围：800 成功 , 900 失败 | 800 | |||
| message | String | 返回消息 | success | |
| returnObj | Object | 返回对象 | returnObj | |
| 表 returnObj |
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| errorMessage | String | 错误信息 | ||
| submitted | Boolean | 是否提交成功 | true | |
| newOrderId | String | 新订单id | 54ea33160b2d47939cc687963edc8da9 | |
| newOrderNo | String | 新订单号 | 800 | |
| totalPrice | String | 返总价 |
枚举参数
无
请求示例
请求url
无
请求头header
{}
请求体body
{
"packageType":2,
"id":"20220419104546394002",
"sellingPrice":100,
"isPlatformSpecificResource":true,
"billingOwner":2,
"isPackage":false,
"chargeOffType":"2",
"paymentPlanInitialMonth":"1514538047000",
"autoPay":true,
"cycleCount":2,
"cycleType":3,
"resourceIds":[
"44b278ae052f48c6905a4cd20071985b"
]
}
响应示例
{
"statusCode": 800,
"message": null,
"returnObj": {
"errorMessage": "",
"submitted": "true",
"orderPlacedEvents": [
{
"errorMessage": "",
"submitted": "true",
"newOrderId": "20220419104546394002 ",
"newOrderNo": "20220907204911413320",
"totalPrice": 100
}
]
}
}
状态码
请参考 状态码
错误码
请参考 错误码
