获取用户月维度的流量信息
更新时间:2019-7-30
1. v3版本
接口描述
该接口用于获取用户月维度的流量信息(仅能2019-07-01及以后日期的流量信息),该版本接口在show_type=3时返回结果中增加了ccr流量数据。
请求地址
https://spark.bokecc.com/api/traffic/user/monthly/v3
请求方式
GET
请求参数
以下请求参数需要进行THQS权限认证, 权限认证方式请参考THQS认证方式。
名称 |
类型 |
必填 |
描述 |
userid |
String |
是 |
用户ID。 |
start_month |
String |
是 |
查询开始日期(含),格式为yyyy-MM。 |
end_month |
String |
是 |
查询结束日期(含),格式为yyyy-MM。 |
show_type |
String |
是 |
显示数据区分维度类型,可选值 1:产品线,2:终端类型,3:媒体类型。 |
请求示例
https://spark.bokecc.com/api/traffic/user/monthly/v3?show_type=1&start_month=2019-07-01&time=1671615487868&end_month=2019-09-01&userid=CC443A6686737xxx&hash=F853DCF6240121EAF8B1E1A3D4063194
返回数据
名称 |
类型 |
说明 |
traffics |
Object |
流量。 |
traffics说明
名称 |
类型 |
说明 |
traffic |
Array |
流量信息。 |
traffic说明
show_type=1时
名称 |
类型 |
说明 |
month |
String |
月时间字符串,格式:yyyy-MM。 |
vod |
Long |
云点播产生的流量,单位:B。 |
live |
Long |
云直播产生的流量,单位:B。 |
live_class |
Long |
云课堂产生的流量,单位:B。 |
返回示例
{
"traffics": {
"traffic": [
{
"month": "2019-07",
"vod": 123789,
"live": 345678,
"live_class": 34
},
......
]
}
}
show_type=2时
名称 |
类型 |
说明 |
month |
String |
月时间字符串,格式:yyyy-MM。 |
pc |
Long |
PC端流量,单位:B。 |
mobile |
Long |
移动端流量,单位:B。 |
返回示例
{
"traffics": {
"traffic": [
{
"month": "2019-07",
"pc": 123789,
"mobile": 345678
},
......
]
}
}
show_type=3时
名称 |
类型 |
说明 |
month |
String |
时间字符串,格式:yyyy-MM。 |
video |
Long |
视频产生的流量,单位:B。 |
audio |
Long |
音频产生的流量,单位:B。 |
ccr |
Long |
CCR流量,单位:B。 |
返回示例
{
"traffics": {
"traffic": [
{
"month": "2019-07",
"video": 123789,
"audio": 345678,
"ccr":23413
},
......
]
}
}
2. v2版本
接口描述
该接口用于获取用户月维度的流量信息(仅能2019-07-01及以后日期的流量信息)。
请求地址
https://spark.bokecc.com/api/traffic/user/monthly/v2
请求方式
GET
请求参数
以下请求参数需要进行THQS权限认证, 权限认证方式请参考THQS认证方式。
名称 |
类型 |
必填 |
描述 |
userid |
String |
是 |
用户ID。 |
start_month |
String |
是 |
查询开始日期(含),格式为yyyy-MM。 |
end_month |
String |
是 |
查询结束日期(含),格式为yyyy-MM。 |
show_type |
String |
是 |
显示数据区分维度类型,可选值 1:产品线,2:终端类型,3:媒体类型。 |
请求示例
https://spark.bokecc.com/api/traffic/user/monthly/v2?show_type=1&start_month=2019-07-01&time=1671615487868&end_month=2019-09-01&userid=CC443A6686737xxx&hash=F853DCF6240121EAF8B1E1A3D4063194
返回数据
名称 |
类型 |
说明 |
traffics |
Object |
流量。 |
traffics说明
名称 |
类型 |
说明 |
traffic |
Array |
流量信息。 |
traffic说明
show_type=1时
名称 |
类型 |
说明 |
month |
String |
月时间字符串,格式:yyyy-MM。 |
vod |
Long |
云点播产生的流量,单位:B。 |
live |
Long |
云直播产生的流量,单位:B。 |
live_class |
Long |
云课堂产生的流量,单位:B。 |
返回示例
{
"traffics": {
"traffic": [
{
"month": "2019-07",
"vod": 123789,
"live": 345678,
"live_class": 34
},
......
]
}
}
show_type=2时
名称 |
类型 |
说明 |
month |
String |
月时间字符串,格式:yyyy-MM。 |
pc |
Long |
PC端流量,单位:B。 |
mobile |
Long |
移动端流量,单位:B。 |
返回示例
{
"traffics": {
"traffic": [
{
"month": "2019-07",
"pc": 123789,
"mobile": 345678
},
......
]
}
}
show_type=3时
名称 |
类型 |
说明 |
month |
String |
时间字符串,格式:yyyy-MM。 |
video |
Long |
视频产生的流量,单位:B。 |
audio |
Long |
音频产生的流量,单位:B。 |
返回示例
{
"traffics": {
"traffic": [
{
"month": "2019-07",
"video": 123789,
"audio": 345678
},
......
]
}
}