直播按流维度查询流量

GetLiveFlowDataByStream

描述

本接口用于获取按流为维度的流量数据，单位：byte

支持按指定的起止时间查询，两者需要同时指定

支持批量流名过滤查询，多个流名用逗号（半角）分隔

最多可获取最近62天内，7天跨度的数据

统计粒度：5分钟粒度；10分钟粒度；20分钟粒度；1小时粒度；4小时粒度；8小时粒度；1天粒度；以上粒度的流量值均取该粒度时间段的流量之和

时效性：5分钟延迟

只支持直播业务

接口性能：接口最大吞吐量为10000，即Region个数*StreamUrl个数*(EndTime-StartTime) /统计粒度 <= 10000。注：在获取多个流名多个区域合并值时，Region个数和StreamUrl个数按照1计算

使用场景：

客户查询一个或多个流名的流量数据汇总，绘制按流名的曲线

客户查询单个流名的详细流量数据，进行数据保存及数据分析

请求语法

本接口请求需要包含指定目录 /2016-09-01/statistics/GetLiveFlowDataByStream和公共请求header和该接口所特有的请求参数，具体请求语句参照下文请求示例。

请求参数：

参数名

必选

类型及范围

说明

StartTime

是

String

获取数据起始时间点，日期格式按ISO8601表示法，北京时间，格式为：YYYY-MM-DDThh:mm+0800，例如： 2016-08-01T21:14+0800

EndTime

是

String

结束时间需大于起始时间；获取日期格式按照ISO8601表示法，北京时间，格式为：YYYY-MM-DDThh:mm+0800，例如： 2016-08-01T21:14+0800

StreamUrls

是

String

拉流URL（参数除外），支持批量查询，多个URL用逗号（半角）分隔。注：对于HLS格式，查询时需删除/index.m3u8后缀，即为http://domain/app/stream格式

Regions

否

String

区域名称，取值为CN:中国大陆，HK：中国香港，AS：亚洲其他，NA：北美洲，SA：南美洲，EU：欧洲，AU：大洋洲，AF：非洲，支持多计费区域查询，多个区域用逗号（半角）分隔，缺省为 CN

ResultType

是

Int

取值为0：多流名多区域数据做合并；1：每个流名每个区域的数据分别返回。

Granularity

否

Int

统计粒度，取值为 1（默认）：1分钟粒度；取值为 5：5分钟粒度；10：10分钟粒度；20：20分钟粒度；60：1小时粒度；240：4小时粒度；480：8小时粒度；1440：1天粒度；以上粒度均取该粒度时间段的流量总和

返回参数

参数名

类型及范围

说明

StartTime

String

开始时间

EndTime

String

结束时间

Regions

String

区域，逗号（半角）间隔

ResultType

Int

0：多流名多区域数据做合并返回；1：每个域名每个区域的数据分别返回。

Granularity

Int

统计粒度， 5：5分钟粒度；10：10分钟粒度；20：20分钟粒度；60：1小时粒度；240：4小时粒度；480：8小时粒度；1440：1天粒度；以上粒度均取该粒度时间段的流量总和

Datas

DataByTime[]

每个时间粒度的流量数据

DataByTime

参数名

类型及范围

说明

Time

String

时间点

Flow

Long

流量（所选流名的流量合并值），单位：byte

Streams

DataByStream[]

每个流的详细流量数据(仅当ResultType取值为1时返回此项数据)

DataByStream

参数名

类型及范围

说明

StreamUrl

String

拉流URL；对于HLS格式，返回参数无后缀，即只返回http://domain/app/stream格式

Flow

Long

流量（该流名的流量，若选择多个区域，则返回该域名多个区域的数据合并值），单位：byte

Regions

DataByRegion[]

该流名在每个区域的流量详细数据

DataByRegion

参数名

类型及范围

说明

Region

String

区域

Flow

Long

该流名在该区域的流量数据，单位：byte

示例

请求示例

POST方式:

POST /2016-09-01/statistics/GetLiveFlowDataByStream 1.1 Host: cdn.api.ksyun.com X-Amz-Date: date Authorization:authorization string x-action: GetLiveFlowDataByStream x-version: 2016-09-01 Content-Type: application/x-www-form-urlencoded StartTime=2016-09-18T09:14+0800&EndTime=2016-09-19T10:20+0800&ResultType=1&Granularity=1440&StreamUrls=rtmp://test.cn/live/ffea40ea2f8e4a5e95096e0f89227092&Regions=CN

返回示例

JSON格式：

{ "StartTime": "2016-09-18T09:14+0800", "EndTime": "2016-09-19T10:20+0800", "Regions": "CN", "ResultType": 1, "Granularity": 1440, "Datas": [ { "Time": "2016-09-18T00:00+0800", "Flow": 2437780224, "Streams": [ { "StreamUrl": "rtmp://test.cn/live/ffea40ea2f8e4a5e95096e0f89227092", "Flow": 2437780224, "Regions": [ { "Region": "CN", "Flow": 2437780224 } ] } ] }, { "Time": "2016-09-19T00:00+0800", "Flow": 143, "Streams": [ { "StreamUrl": "rtmp://test.cn/live/ffea40ea2f8e4a5e95096e0f89227092", "Flow": 143, "Regions": [ { "Region": "CN", "Flow": 143 } ] } ] } ] }

错误码

下方为接口业务逻辑相关的错误码，其他错误码详见公共错误码

错误代码(Code)

错误消息(Message)

HTTP 状态码

中文描述（语义）

InvalidStartTime.Malformed

Specified start time is malformed.StartTime:%s

400

StartTime格式错误

NoDataProvided

We do not provide data more than 1 year.

400

所查询的时间范围超过限制

InvalidEndTime.Malformed

Specified end time is malformed.%s

400

EndTime格式错误

InvalidEndTime.Mismatch

Specified end time should not be earlier than start time.StartTime:%s, EndTime:%s

400

EndTime不应早于StartTime

InvalidTime

Start time with the time difference is not more than 62 days.

400

不支持查询62天前的数据

InvalidTime

The start time and the end time difference is not more than 7 days.

400

所查询的时间跨度不能超过7天

InvalidRegion

Invalid region.Expected:AF/AS/AU/CN/EU/NA/SA/HK/TW, but receive:%s

400

无效的区域名称

InvalidResultType

Invalid result type.Expected:0/1, but receive:%s

400

无效的数据类型，应该为0/1

InvalidGranularity

Invalid granularity.Option for granularity is 5, 10, 20, 60, 240, 480, 1440 (min), received:%s

400

无效的统计粒度

RequiresInputValue

Requires no input value.Expected:This value is required, but no found value from:StreamUrls

400

缺少必填参数

InvalidDomain.NotFound

The domain provided does not belong to you or does not match the cdntype.Invalid domains:%s

400

直播业务不存在此域名

AccessDenied

Access Denied.You are not authorized to perform:DomainIds:%s

403

权限不够，访问被拒绝

TooManyDataPoints

Too many data points in this request.%s

400

所查询的数据超过接口最大吞吐量

网址：直播按流维度查询流量 https://mxgxt.com/news/view/1403435

相关内容

查询流量的app大全
辛巴假燕窝被调查，头部网红成也流量败也流量
顺飞物流查询系统 物流状态追踪 最新快递动态一手掌握
红人主播林珊珊入驻星查查，多维度赋能直播电商价值之路
按流行度传唱度分档歌手。。
如何挖掘直播流量数据呢
LG冰箱维修电话查询
抖音直播带货，直播间付费流量和自然流量的相互关系
媒体曝光量查询解决方案
直播带货运营全流程 思维导图模板

随便看看