主题
接口描述
获取节点带宽信息 (查询跨度最大 31 天)
请求路径
POST
/v1/nodes/stats
请求参数
名称 | 类型 | 位置 | 必须 | 描述 |
---|---|---|---|---|
Authorization | string | header | 是 | 鉴权 token |
Content-Type | string | header | 是 | 数据类型 application/json |
nodeIDs | []string | body | 是 | 节点 IDs,单次最大查询 100 个节点 |
start | string | body | 是 | 开始时间,格式:yyyy-MM-dd |
end | string | body | 是 | 结束时间,格式:yyyy-MM-dd |
返回值
名称 | 类型 | 描述 |
---|---|---|
data | []StatInfo | 带宽数据 |
StatInfo
名称 | 类型 | 描述 |
---|---|---|
nodeID | string | 节点 ID |
dayPeak95 | map | 日 95 带宽列表,key 为 yyyy-MM-dd 格式的日期,value 为 Bps 单位的带宽数据 |
请求示例
json
{
"nodeIDs": ["hdshkdjsdkj", "hdshkdjdasd"],
"start": "2022-02-18",
"end": "2022-02-24"
}
返回值示例
json
正常请求:
http code 200
{
"data": [
{
"nodeID": "hdshkdjsdkj",
"dayPeak95": {
"2022-02-19":65679202848,
"2022-02-18":57239435121,
"2022-02-23":52205484461,
"2022-02-22":61799374812,
"2022-02-24":50613415519,
"2022-02-21":57196523714,
"2022-02-20":63258491156
}
}
]
}
异常请求:
http code 4xx/5xx
{
"code": 4000001,
"desc": ""
}
错误码列表
错误码 | 描述 |
---|---|
401 | 鉴权失败 |
4000002 | 节点未查找到 |
如接口返回错误码未列举,可在错误码总览中查找