静态-续费计价
在续费前计算指定静态 IP 列表的总价及分地区明细。
鉴权
所有渠道商接口均需在请求头中携带 accessKeySecret。密钥在渠道商管理平台中获取，并可根据需要重置。详见 通用信息。
接口描述
| 项目 | 说明 |
|---|---|
| 方法 | POST |
| 地址 | https://api2.ipmart.io/custom/static/computRenewPayTotalPriceV2 |
输入参数
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| subUserId | 是 | String | 子用户 ID |
| staticIps | 是 | Array | 待续费静态 IP 列表 |
| days | 是 | Int | 续费天数 |
重要输出参数
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| status | 是 | Int | 返回码 |
| errorMsg | 否 | String | 错误信息（含不可续费原因） |
| data | 是 | Object | 计价结果，字段见下 |
| totalPrice | 是 | Number | 续费总价（渠道商专属单价 × 数量；最多保留 2 位小数且向下取整；位于 data.totalPrice） |
| detail | 是 | String | 按地区聚合的 JSON 字符串（位于 data.detail），元素字段见下 |
detail JSON 元素
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| areaCode | 是 | String | 区域编码 |
| countryCode | 是 | String | 国家编码 |
| cityCode | 是 | String | 城市编码 |
| areaName | 是 | String | 区域名称 |
| countryName | 是 | String | 国家名称 |
| cityName | 是 | String | 城市名称 |
| price | 是 | String | 该地区续费单价（时间折扣后） |
| count | 是 | Int | 该地区续费 IP 数量 |
| time | 是 | Int | 续费天数 |
发送示例
json
{
"subUserId": "661f908102ca4953bc555a18",
"staticIps": ["154.196.142.192", "154.196.142.193"],
"days": 30
}返回示例
成功
json
{
"status": 200,
"errorMsg": null,
"data": {
"totalPrice": 7.0,
"detail": "[{\"areaCode\":\"NA\",\"countryCode\":\"US\",\"cityCode\":\"Random\",\"areaName\":\"北美\",\"countryName\":\"美国\",\"cityName\":\"随机\",\"price\":\"3.50\",\"count\":2,\"time\":30}]"
}
}