诺云开放平台

Appearance

每日流量消耗 ​

接口描述 ​

按天查询当前商家的流量消耗，包含标准直播、超低延迟直播和视频流量，并返回所选日期区间的使用流量总量。对应控制台“流量统计 → 每日流量消耗”。

请求路径 ​

  • 请求方式：POST
  • 请求头：Content-Type:application/json
  • 接口地址：https://gateway.nuoyunapi.com/Api/Traffic/trafficConsumeList/2.0.0
  • 频率限制：每接口 10秒100次，按客户端 IP 和 User-Agent 区分。
  • 身份认证：参考接口签名介绍，仅查询调用凭证所属商家的数据，无需传入 uid。

请求参数 ​

参数必选类型描述示例值
page是integer页码，从1开始1
page_size是integer每页日期数量，范围1至10010
search_time是string查询范围：yesterday 昨日、week 本周、month 本月、custom 自定义日期"custom"
start_time条件必填stringsearch_time=custom 时必填，开始日期，格式 YYYY-MM-DD"2026-10-20"
end_time条件必填stringsearch_time=custom 时必填，结束日期，格式 YYYY-MM-DD，不得早于开始日期；晚于昨天时自动按昨天截止"2026-10-21"

统计说明 ​

  • 单次查询日期范围最多366天。
  • 日期按北京时间（UTC+8）解释，包含开始日期和结束日期的全天数据，按日期倒序返回。
  • 仅查询北京时间昨天及以前的数据；结束日期晚于昨天时自动截到昨天，count、分页与汇总均按实际查询区间计算。整个区间均在今天或未来时返回 count=0、total_in_time="0.00GB"、list=[]。
  • yesterday 查询昨日；week 查询本周一至昨日，周一返回空列表；month 查询本月1日至昨日，每月1日返回空列表。快捷范围无需传入 start_time、end_time。
  • 按日期分页，昨天及以前的某日没有流量时，该日仍返回记录，各流量字段为 "0.00"；不补今天及未来日期。
  • 流量单位为 GB，1 GB = 1,000,000,000 字节，保留两位小数。统计值可能随数据更新而变化。
  • vod_bytes 为全部视频流量，包含 vod_room_bytes（直播间视频流量）与 vod_other_bytes（其他视频流量）。汇总时不要再次叠加这两个子项。
  • total_in_time 为整个查询区间的标准直播、超低延迟直播和视频流量合计，不受当前分页影响。各项独立保留两位小数，展示值相加可能存在舍入差异。

请求示例 ​

json
{
  "page": 1,
  "page_size": 10,
  "search_time": "custom",
  "start_time": "2026-10-20",
  "end_time": "2026-10-21"
}

响应参数 ​

参数必选类型描述示例值
code是integer业务状态码，200 成功，400 失败200
msg是string提示信息"Success"
data是object查询结果；以下结构为成功时返回见响应示例

data 参数结构 ​

参数必选类型描述示例值
count是integer实际查询区间内的日期总数（最多截止昨天），不是当前页记录数2
total_in_time是string查询区间使用流量总量，带 GB 后缀"7.00GB"
list是array当前页的每日流量记录见响应示例

list 参数结构 ​

参数必选类型描述示例值
date是string统计日期，格式 YYYY-MM-DD"2026-10-21"
type是string资源类型，固定为“流量”"流量"
live_bytes是string标准直播使用流量，单位 GB，无单位后缀"1.20"
no_delay_bytes是string超低延迟直播使用流量，单位 GB，无单位后缀"0.30"
vod_bytes是string视频使用流量，单位 GB，无单位后缀"2.50"
vod_other_bytes是string其他视频使用流量，单位 GB，无单位后缀"0.50"
vod_room_bytes是string直播间视频使用流量，单位 GB，无单位后缀"2.00"

响应示例 ​

以下数据均为示例数据。

json
{
  "code": 200,
  "msg": "Success",
  "data": {
    "count": 2,
    "total_in_time": "7.00GB",
    "list": [
      {
        "date": "2026-10-21",
        "type": "流量",
        "live_bytes": "1.20",
        "no_delay_bytes": "0.30",
        "vod_bytes": "2.50",
        "vod_other_bytes": "0.50",
        "vod_room_bytes": "2.00"
      },
      {
        "date": "2026-10-20",
        "type": "流量",
        "live_bytes": "1.00",
        "no_delay_bytes": "0.20",
        "vod_bytes": "1.80",
        "vod_other_bytes": "0.30",
        "vod_room_bytes": "1.50"
      }
    ]
  }
}

状态码说明 ​

状态码描述
200查询成功
400参数不符合要求、请求过于频繁或服务暂不可用，请根据 msg 调整请求
601数据查询异常，请稍后重试

相关接口 ​