Skip to content

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-IDString应用唯一标识 (appId)10001
X-NONCEString随机数k9m2Pq7wL1
X-TIMESTAMPLong当前 Unix 时间戳 (秒)1713165000
X-SIGNString动态签名d3b1...

签名生成逻辑请参考:签名生成指南

3. 请求参数说明 (Body)

字段名类型是否必填描述示例
ipIdsArray需要续费的 IP ID 列表(Integer 数组)[86, 87]
durationInteger续费时长(单位:天)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)

字段名类型描述
codeInteger状态码,0 表示成功
dataObject续费结果
orderNoString新的订单编号
msgString提示信息

响应示例

json
{
    "code": 0,
    "data": {
      "orderNo": "MO202604231536109260002",
    },
    "msg": "success"
}