GetLivePlayStatData

描述

本接口用于获取某个时间点的播放统计综合信息（5分钟粒度），包括域名维度和流维度的带宽、流量、在线人数，单位：带宽：bit/s，流量：byte，在线人数：个

• 只需要设置起始时间，代表起始时间这5分钟的数据

• 支持批量域名过滤查询

• 最多可获取最近62天内的数据

• 时效性：5-10分钟延迟

• 本接口对应的数据每分钟更新一次，不适合过度频繁调用，每个UID限制访问频率300次/分钟

• 本接口的域名维度数据支持HDL(HTTP-FLV)、RTMP、HLS协议，但流维度数据仅支持HDL(HTTP-FLV)、RTMP协议，不支持HLS协议。如果输入中含有HLS协议的域名，则HLS协议的域名仅返回域名维度数据，不返回流维度数据

• 仅能返回在线人数Top1万的流记录。如果您的单域名下同时存在的流数量超过1万个，建议在应用场景上分域名处理，保障每个域名下同时存在的流数小于1万个

• 由于域名维度的数据与流维度的数据计算方式不同，域名维度的数据与流维度的数据的加和，二者会有一定偏差

• 只支持直播业务

• 使用场景：

  • 客户查询一个单位时间（5分钟）内的直播总量数据、流维度数据，进行数据保存及数据分析

请求语法

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

请求参数

返回参数

PlayStatDataByDomain

PlayStatDataByStream

示例1：获取域名维度的汇总数据

请求示例

POST方式:

POST /2016-09-01/statistics/GetLivePlayStatData
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: GetLivePlayStatData
x-version: 2016-09-01
Content-Type: application/GetLivePlayStatData
{
	"StartTime": "2018-06-20T16:14+0800",
	"ResultType": 0,
	"LimitN": 100
}

返回示例

JSON格式：

{
	"StartTime": "2018-06-20T16:19+0800",
	"DomainIds": "2D09FJS,2D09QS1,2D09FRV,2D09FRU,2D09QS0,2D09QS2",
	"Regions": "CN",
	"ResultType": 0,
	"LimitN": 1000,
	"Datas": [{
		"DomainId": "2D09QS2",
		"Bw": 920424,
		"Flow": 34516131,
		"OnlineUser": 2
	}]
}

示例2：获取域名维度+流维度的详细数据

请求示例

POST方式:

POST /2016-09-01/statistics/GetLivePlayStatData
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: GetLivePlayStatData
x-version: 2016-09-01
Content-Type: application/GetLivePlayStatData
{
	"StartTime": "2018-06-20T16:14+0800",
	"ResultType": 1,
	"LimitN": 100
}

返回示例

JSON格式：

{
	"StartTime": "2018-06-20T16:14+0800",
	"DomainIds": "2D09FJS,2D09QS1,2D09FRV,2D09FRU,2D09QS0,2D09QS2",
	"Regions": "CN",
	"ResultType": 1,
	"LimitN": 1000,
	"Datas": [{
		"DomainId": "2D09QS2",
		"Bw": 1018784,
		"Flow": 38204663,
		"OnlineUser": 2,
		"Streams": [{
			"StreamUrl": "rtmp://videoqa.rtmplive.ks-cdn.com/qa-nice/pie-test-12f79bbb-12da-1c02-b12f-1b6cd0ef8f2d",
			"Bw": 537232,
			"Flow": 20146427,
			"OnlineUser": 1
		}, {
			"StreamUrl": "rtmp://videoqa.rtmplive.ks-cdn.com/qa-nice/pie-test-12f79bbb-12da-1c02-b12f-1b6cd0ef8f2d_h264",
			"Bw": 382856,
			"Flow": 14357315,
			"OnlineUser": 1
		}, {
			"StreamUrl": "rtmp://videoqa.rtmplive.ks-cdn.com/qa-nice/pie-test-34e43490-abab-4342-bd34-c0b65e34c2ac",
			"Bw": 64088,
			"Flow": 2403559,
			"OnlineUser": 0
		}, {
			"StreamUrl": "rtmp://videoqa.rtmplive.ks-cdn.com/qa-nice/pie-test-34e43490-abab-4342-bd34-c0b65e34c2ac_h264",
			"Bw": 34592,
			"Flow": 1297360,
			"OnlineUser": 0
		}]
	}]
}

错误码

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