IP 批量续费 (Renew by Proxy IDs)
1. 接口描述
该接口支持通过传入一组 IP 的唯一标识符(ipIds)进行跨订单批量续费。与“基于订单续费”不同,此接口允许您从不同订单中勾选特定的 IP 进行统一续费操作。
- 请求方式:
POST - 接口地址:
https://api.cueip.com/api/static-proxy/renew-by-ips - 内容类型:
application/json
2. 请求头规范 (Header)
所有请求必须包含以下安全校验字段
| 字段名 | 类型 | 是否必填 | 描述 | 示例 |
|---|---|---|---|---|
| X-APP-ID | String | 是 | 应用唯一标识 (appId) | 10001 |
| X-NONCE | String | 是 | 随机数 | k9m2Pq7wL1 |
| X-TIMESTAMP | Long | 是 | 当前 Unix 时间戳 (秒) | 1713165000 |
| X-SIGN | String | 是 | 动态签名 | d3b1... |
签名生成逻辑请参考:签名生成指南
3. 请求参数说明 (Body)
| 字段名 | 类型 | 是否必填 | 描述 | 示例 |
|---|---|---|---|---|
| ipIds | Array | 是 | 需要续费的 IP ID 列表(Integer 数组) | [86, 87] |
| duration | Integer | 是 | 续费时长(单位:天) | 30 |
注:虽然示例中只传了一个 ID,但该字段支持传入多个 ID 以实现批量操作。
4. 请求示例
http
POST /api/static-proxy/renew-by-ips
Host: api.cueip.com
Content-Type: application/json
{
"ipIds": [86, 87],
"duration": 30
}5. 响应参数说明
成功响应 (200 OK)
| 字段名 | 类型 | 描述 |
|---|---|---|
code | Integer | 状态码,0 表示成功 |
data | Object | 续费结果 |
└ orderNo | String | 新的订单编号 |
msg | String | 提示信息 |
响应示例
json
{
"code": 0,
"data": {
"orderNo": "MO202604231536109260002",
},
"msg": "success"
}