Skip to content

基于订单续费 (Renew by Order)

1. 接口描述

该接口用于对某个特定订单进行整单续费。调用后,该订单号关联的所有静态 IP 将统一按指定的时长进行延期。这在管理大量属于同一批次购买的 IP 时非常高效。

  • 请求方式POST
  • 接口地址https://api.cueip.com/api/static-proxy/renew-by-order
  • 内容类型application/json

2. 请求头规范 (Header)

所有请求必须包含以下安全校验字段

字段名类型是否必填描述示例
X-APP-IDString应用唯一标识 (appId)10001
X-NONCEString随机数k9m2Pq7wL1
X-TIMESTAMPLong当前 Unix 时间戳 (秒)1713165000
X-SIGNString动态签名d3b1...

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

3. 请求参数说明 (Body)

字段名类型是否必填描述示例
orderNoString需要续费的订单编号MO202604231536109260001
durationInteger续费时长(单位:天)30

4. 请求示例

http
POST /api/static-proxy/renew-by-order
Host: api.cueip.com
Content-Type: application/json

{
    "orderNo": "MO202604231536109260001",
    "duration": 30
}

5. 响应参数说明

成功响应 (200 OK)

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

响应示例

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