续费静态代理

接口用途

此接口用于为一个或多个静态代理续费。续费会产生余额扣款，请在发送请求前确认代理 ID、续费天数和账号余额。

请求信息

POST /openapi/static/node/renew

完整地址：

https://{domain}/openapi/static/node/renew

请求时必须携带 user-id 和 access-key Header。

Body 参数

单个代理续费的参数内容示例：

{
  "renew_days": 30,
  "node_id": "xK9mP2nQ"
}

多个代理续费的参数内容示例：

{
  "renew_days": 30,
  "node_id": "xK9mP2nQ,yL0nR3sT"
}

注意：当前接口资料未标明请求 Body 的 Content-Type。正式接入前，请以 QuarkIP 为您的环境提供的最新要求为准，并据此选择 JSON、表单或其他提交格式。

返回字段

成功响应示例

{
  "code": 0,
  "msg": "Ok",
  "info": {
    "trade_no": "gH7iJ9kL",
    "renew_days": 30,
    "node_qty": 3
  }
}

请求成功后，请保存 trade_no。您可以使用《查询静态代理交易详情》中的接口核对订单金额、代理数量和交易类型。

续费前的检查建议

• 确认每个 node_id 均属于当前账号。
• 确认代理支持续费。
• 确认 renew_days 符合产品允许的续费周期。
• 确认账号余额足够支付本次续费。
• 对于自动化调用，请妥善处理重复提交，避免在结果未知时立即重复续费。

常见错误

• 400：缺少 renew_days 或 node_id 等必要参数。
• 402：账号余额不足。
• 403：代理不支持续费。
• 422：续费天数或其他业务校验未通过。

缺少代理参数时，错误信息可能显示 missing params node_ids。实际请求参数名仍为 node_id。