API接口 / 隧道代理IP / 续费订单
隧道代理IP · 续费订单
推荐阅读时长：3分钟使用账户余额续费隧道代理IP订单，支持按天或按月续费。仅处理当前用户的隧道产品订单。
接口信息
| 项目 | 内容 |
|---|---|
| 请求方式 | POST |
| 接口路径 | /api/v1/tunnel/renew |
| Authorization | Bearer YOUR_TOKEN（替换为登录后取得的Token） |
| Content-Type | application/json |
| Accept | application/json |
鉴权配置见鉴权方式。以下均为说明性示例，未执行真实业务请求；示例订单号、账号及密码均为占位值。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
orderNo |
string[] | 是 | 订单号数组，即使只续费一个订单也需要使用数组。 |
timeType |
string | 是 | 天卡或月卡。 |
time |
integer | 是 | 续费天数或月数，必须为正整数。 |
请求示例：按月续费
{
"orderNo": [
"TUN_EXAMPLE_001"
],
"timeType": "月卡",
"time": 1
}请求示例：按天批量续费
{
"orderNo": [
"TUN_EXAMPLE_001",
"TUN_EXAMPLE_002"
],
"timeType": "天卡",
"time": 3
}响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
code |
integer | 200表示续费成功，400表示失败。 |
msg |
string | 业务结果说明。 |
data |
array | 当前成功时为空数组。 |
成功响应示例
{
"code": 200,
"msg": "续费成功",
"data": []
}订单未匹配示例
{
"code": 400,
"msg": "订单不存在",
"data": []
}其他失败示例
{
"code": 400,
"msg": "订单续费失败",
"data": []
}注意事项
参数校验或支付等异常可能统一返回“订单续费失败”，不保证对外返回详细的余额不足原因。成功后通过订单查询核对结束时间；网络响应丢失时先确认订单状态，再决定是否重试，避免重复续费。
