获取流量扣费明细

分页获取最近 N 天的流量扣费流水（按时间倒序）。汇总字段 total / total_traffic / total_charged 仅在 page=1 时返回，翻页时请复用第一页的汇总结果。响应中的 limit 为按 1-200 规范化后的值，但数据层实际单页最多返回 100 条。

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

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

错误响应：

code	msg
401	authorization header is missing
401	invalid token
403	OAuth2权限不足，需要以下权限之一: traffic:read
500	获取扣费明细失败: <错误信息>

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "user_id": "1",
    "days": 7,
    "start_time": "2026-09-18T00:00:00+08:00",
    "end_time": "2026-09-24T23:59:59+08:00",
    "page": 1,
    "limit": 20,
    "charges": [
      {
        "time": "2026-09-24T10:00:00+08:00",
        "node_id": "1",
        "node_name": "香港-01",
        "remark": "我的网站",
        "traffic_in": 1048576,
        "traffic_out": 2097152,
        "traffic_total": 3145728,
        "traffic_ratio": 1.5,
        "charged": 4718592
      }
    ],
    "total": 1,
    "total_traffic": 3145728,
    "total_charged": 4718592
  }
}

🟠401错误 401

🟠403错误 403

🔴500错误 500

获取流量扣费明细

请求参数

请求示例代码

返回响应