诺云开放平台

Appearance

视频流量消耗 ​

接口描述 ​

查询当前商家指定日期区间内的视频流量消耗，包含回放视频和素材视频，支持按视频名称或素材ID筛选。对应控制台“流量统计 → 视频流量消耗”。

请求路径 ​

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

请求参数 ​

参数必选类型描述示例值
page是integer页码，从1开始1
page_size是integer每页视频记录数量，范围1至10010
start_time是string开始日期，格式 YYYY-MM-DD"2026-10-01"
end_time是string结束日期，格式 YYYY-MM-DD，不得早于开始日期"2026-10-21"
file_name否string视频名称，最多100个字符，模糊查询；不传则不按名称筛选"示例视频"
file_id否integer素材ID，对应返回记录的 id，不是返回记录中的字符串 file_id；不传则不按素材ID筛选10001

统计说明 ​

  • 单次查询日期范围最多366天。
  • 日期按北京时间（UTC+8）解释，包含开始日期和结束日期的全天数据；支持查询自 2022-05-30 起的流量数据。
  • 按视频记录分页，total_traffic 为整个日期区间内符合筛选条件的视频流量合计，不受当前分页影响。
  • 流量单位为 GB，1 GB = 1,000,000,000 字节，保留两位小数。total_traffic 带 GB 后缀，记录中的 data_bytes 不带单位后缀。
  • data_reqs 表示播放请求次数，不是去重观看人数。
  • id 是素材ID；回放视频尚无对应素材时可能为 0。字符串 file_id 是视频文件标识，两者不可混用。
  • 没有符合条件的视频记录时，返回 total=0、total_traffic="0.00GB" 和空数组 list=[]。

请求示例 ​

json
{
  "page": 1,
  "page_size": 10,
  "start_time": "2026-10-01",
  "end_time": "2026-10-21",
  "file_name": "示例视频"
}

响应参数 ​

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

data 参数结构 ​

参数必选类型描述示例值
total是integer符合筛选条件的视频记录总数1
total_traffic是string日期区间内符合筛选条件的视频使用流量，带 GB 后缀"1.25GB"
list是array当前页视频流量记录见响应示例

list 参数结构 ​

参数必选类型描述示例值
id是integer素材ID，无对应素材时为 010001
upload_name是string视频名称"示例视频"
business_type是string视频类型："1" 回放视频、"4" 素材视频"4"
snap_url是string视频封面地址，无封面时可为空字符串"https://example.com/video-cover.jpg"
size是string视频文件大小，带单位的格式化文本，不是流量消耗"50.00 MB"
video_dur是string视频时长文本"00:15:30"
data_reqs是integer日期区间内的播放请求次数50
data_bytes是string日期区间内的视频使用流量，单位 GB，无单位后缀"1.25"
file_id是string视频文件标识，不是素材ID"example_video_file_001"

响应示例 ​

以下数据均为示例数据。

json
{
  "code": 200,
  "msg": "Success",
  "data": {
    "total": 1,
    "total_traffic": "1.25GB",
    "list": [
      {
        "id": 10001,
        "upload_name": "示例视频",
        "business_type": "4",
        "snap_url": "https://example.com/video-cover.jpg",
        "size": "50.00 MB",
        "video_dur": "00:15:30",
        "data_reqs": 50,
        "data_bytes": "1.25",
        "file_id": "example_video_file_001"
      }
    ]
  }
}

状态码说明 ​

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

相关接口 ​