接口描述

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

请求路径

POST /v1/nodes/batch/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	带宽数据

StatInfo

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

请求示例

返回值示例

正常请求:
  http code 200
{
  "nodeDatas": [
    {
      "nodeId": "xx",
      "data": [
        {
          "time": 1630360800,
          "up": 1000,
          "down": 2000
        },
        {
          "time": 1630360900,
          "up": 1000,
          "down": 2000
        }
      ]
    }
  ]
}

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

错误码列表

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

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