接口描述

批量获取节点带宽信息 (查询跨度最大 3 天)

请求路径

POST /v1/ant/nodes/stats

请求参数

名称	类型	位置	必须	描述
Authorization	string	header	是	鉴权 token
nodeIds	[]string	json	是	节点 Ids；单次最大查询 100 个节点
granularity	string	json	是	粒度 5min：五分钟 hour：一小时
start	string	json	是	开始时间，格式：yyyyMMddHHmm
end	string	json	是	结束时间，格式：yyyyMMddHHmm

返回值

名称	类型	描述
nodeDatas	[]NodeStatInfo

NodeStatInfo

名称	类型	描述
nodeId	string	节点 Id，与参数中的 nodeIds 对应
data	[]StatInfo	带宽数据
errorCode	int	错误码

StatInfo

名称	类型	描述
time	int	时间，时间戳：秒
up	int	上行带宽，单位：bps
down	int	下行带宽，单位：bps

请求示例

{
  "nodeIds": ["xx"],
  "granularity": "hour",
  "start": "202502240000",
  "end": "202502240500"
}

返回值示例

正常请求:
  http code 200
{
  "nodeDatas": [
    {
      "nodeId": "xx",
      "data": [
        {
          "time": 1740326400,
          "up": 1000,
          "down": 2000
        },
        {
          "time": 1740330000,
          "up": 1000,
          "down": 2000
        }
      ],
      "errorCode": 0
    }
  ]
}

异常请求:
  http code 4xx/5xx
{
  "code": 4000001,
  "desc": ""
}

错误码列表

错误码	描述
401	鉴权失败
4000002	节点未查找到

如接口返回错误码未列举，可在错误码总览中查找