隧道代理IP订单查询API接口文档

API接口 / 隧道代理IP / 订单查询

隧道代理IP · 订单查询

推荐阅读时长：5分钟

分页查询当前用户的隧道代理订单，获取代理入口、账号、有效期、带宽、并发数及IP更换周期。

接口信息

项目	内容
请求方式	POST
接口路径	`/api/v1/tunnel/orderList`
Authorization	`Bearer YOUR_TOKEN`（替换为登录后取得的Token）
Content-Type	`application/json`
Accept	`application/json`

鉴权配置见鉴权方式。以下均为说明性示例，未执行真实业务请求；示例订单号、账号及密码均为占位值。

请求参数

参数	类型	必填	说明
`orderNo`	string	否	按订单号精确筛选；省略或空字符串表示不筛选。
`page`	integer	否	页码，默认1；无效正整数页码回退为1。
`limit`	integer	否	每页数量，默认10。当前方法未设置显式上限，请使用合理的正整数。

请求示例：分页查询

{
  "page": 1,
  "limit": 10
}

请求示例：指定订单

{
  "orderNo": "TUN_EXAMPLE_001",
  "page": 1,
  "limit": 10
}

响应字段

字段	类型	说明
`code`	integer	成功为200；控制器失败通常为400。
`msg`	string	结果说明。
`data.items`	object[]	当前页订单数组，无匹配时为空数组。
`data.total`	integer	匹配订单总数。
`data.page`	integer	当前页码。

订单字段（data.items[]）

字段	类型	说明
`order_no`	string	订单号。
`band`	integer / string / null	带宽，单位M。
`server`	string	服务器地址与端口，格式为SERVER:PORT。
`province_code`	null	当前固定为null。
`province`	string / null	省份。
`project_id`	integer / string / null	项目ID。
`city_code`	null	当前固定为null。
`city`	string / null	城市。
`username`	string	代理账号。
`password`	string	代理密码，请妥善保管。
`start_time`	string	开始时间，常见格式YYYY-MM-DD HH:mm:ss。
`end_time`	string	结束时间，常见格式YYYY-MM-DD HH:mm:ss。
`status`	integer / string / null	订单状态，1通常为有效、0通常为失效。
`area`	string	省份-城市。
`isp`	string / null	运营商。
`pid`	integer / string / null	产品ID
`node_status`	integer	当前固定为1，不是实时节点健康检测。
`concurrent`	integer / string / null	并发限制。
`ipCycle`	integer / string / null	IP更换周期，单位秒。

成功响应示例

{
  "code": 200,
  "msg": "获取订单列表成功",
  "data": {
    "items": [
      {
        "order_no": "TUN_EXAMPLE_001",
        "band": 5,
        "server": "203.0.113.20:10001",
        "province_code": null,
        "province": "四川",
        "project_id": null,
        "city_code": null,
        "city": "成都",
        "username": "example_user",
        "password": "ExamplePwd123",
        "start_time": "2026-09-10 10:00:00",
        "end_time": "2026-10-10 10:00:00",
        "status": 1,
        "area": "四川-成都",
        "isp": "电信",
        "pid": 6,
        "node_status": 1,
        "concurrent": 10,
        "ipCycle": 300
      }
    ],
    "total": 1,
    "page": 1
  }
}

空列表示例

{
  "code": 200,
  "msg": "获取订单列表成功",
  "data": {
    "items": [],
    "total": 0,
    "page": 1
  }
}

未登录示例（订单查询控制器）

{
  "code": 400,
  "msg": "用户未登录",
  "data": []
}

查询失败示例

{
  "code": 400,
  "msg": "查询出错",
  "data": []
}

按JSON业务字段code判断结果，不要只判断HTTP 200。认证环节可能先返回其他错误，具体以鉴权说明和实际响应为准。数字字段可能为数字字符串或null，客户端需要兼容。

相关接口：下单购买 · 修改密码 · 设置白名单 · 续费订单 · 订单查询