创建静态代理续费订单

POST /open-api/v1/static/renewal-orders

Base URL：https://api.ipbunker.online/gin。

认证

在请求头传入 X-API-Key。

JSON 请求体

字段	类型	必填	约束	说明
request_no	string	是	minLength: 1; maxLength: 64; pattern: ^[A-Za-z0-9_-]{1,64}$	调用方幂等请求号，1～64 位，仅允许字母、数字、下划线和连字符
resource_ids	string[]	是	minItems: 1; maxItems: 500	待续费资源 ID；去重后数量范围 1～500
duration_days	integer	是	format: int32; minimum: 1	统一续费时长（天），正整数；全部资源使用相同天数，三种静态类型分别按当前用户对应产品线和地区的启用目录校验；混合类型需各分组均有报价，非正整数或格式错误返回 400009，任一分组缺价时整单返回 300320，请联系客户支持
callback_url	string	否	maxLength: 2048	可选终态回调地址；仅允许通过 SSRF 校验的 HTTP/HTTPS 绝对地址，最长 2048 字符

请求示例

curl --request POST \
  --url 'https://api.ipbunker.online/gin/open-api/v1/static/renewal-orders' \
  --header 'Accept: application/json' \
  --header 'X-API-Key: <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "request_no": "static_renew_20260824_001",
  "resource_ids": [
    "1912345678901234567"
  ],
  "duration_days": 30
}'

成功响应中的 data

接口使用 code、msg、data、next 响应结构。HTTP 200 也可能包含非零业务错误码；先检查 code。

字段	类型	必填	约束	说明
data.order_no	string	否	—	静态续费订单号；作为不透明字符串原样使用
data.status	string	否	enum: PROCESSING	异步续费订单状态
data.duration_days	integer	否	format: int32; minimum: 1	统一续费时长（天）
data.total_quantity	integer	否	format: int32; minimum: 1; maximum: 500	去重后的续费资源数量
data.order_amount	string	否	—	订单金额，USD 十进制字符串
data.currency	string	否	—	结算币种
data.create_time	string	否	format: date-time	订单创建时间，GMT+8 带偏移 ISO-8601

接口说明

对 1～500 个去重资源使用钱包全额支付并异步续费；三种静态类型分别按当前用户对应产品线和地区的启用目录校验正整数时长；全部资源使用相同续费天数，混合类型需各分组均有报价；创建响应仅表示订单已受理

相关约定

请求规范 · 响应结构 · 错误码 · API 接口目录