获取单个隧道实时流量

获取指定隧道的累计流量与最新连接数等实时信息。若隧道尚无流量记录会自动创建初始记录（流量为 0）；若隧道不存在，不返回 404，而是返回仅包含 tunnel_name、其余字段为零值的对象。

鉴权：需要用户 JWT（Authorization: Bearer ）

OAuth2：支持 OAuth2 Access Token，需要 scope traffic:read

错误响应：

code	msg
401	authorization header is missing
401	invalid token
403	OAuth2权限不足，需要以下权限之一: traffic:read
400	隧道名称不能为空
500	获取隧道实时流量失败: <错误信息>

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "tunnel_name": "3f2a9c1e0b7d4e6fa1c2d3e4f5a6b7c8",
    "node_id": 1,
    "node_name": "香港-01",
    "traffic_in": 1024,
    "traffic_out": 2048,
    "total_traffic": 3072,
    "connections": 2,
    "tunnel_type": "tcp",
    "remote_port": 20001,
    "custom_domain": "",
    "status": "active",
    "remark": "SSH",
    "updated_at": "2026-09-24T10:00:00+08:00"
  }
}

🟠401错误 401

🟠403错误 403

🟠400错误 400

🔴500错误 500

获取单个隧道实时流量

请求参数

请求示例代码

返回响应