按照日期区间或时间段查询分类的播放量、流量、播放时长统计信息

更新时间：2022-05-23 18:01:52

接口URL

https://api.polyv.net/v2/cata/{userid}/stats-info

接口说明

按照日期区间或时间段查询分类的播放量、流量、播放时长统计信息

支持格式

JSON

请求方式

GET

请求参数

参数名	必选	类型及范围	说明
userid	true	string	用户id，路径参数
ptime	true	string	当前13位毫秒级时间戳，3分钟内有效
sign	true	string	签名，40位大写的sha1值
cataid	true	long	分类ID
dr	false	string	时间段，具体值为以下几个：today（今天），yesterday（昨天），this_week（本周），last_week（上周），7days（最近7天），this_month（本月），last_month（上个月），this_year（今年），last_year（去年），默认值为7days
startDate	false	string	开始日期，格式为yyyy-MM-dd
endDate	false	string	结束日期，格式为yyyy-MM-dd
containSubCategory	false	string	是否包含子分类的统计数据，取值Y表示包含子分类，N表示不包含

返回结果

{
  "code": 4,
  "status": "text",
  "message": "",
  "data": [
    {
      "current": "2018-08-01",
      "pcFlowSize": 10,
      "mobileFlowSize": 0,
      "mobilePlayDuration": 9,
      "pcPlayDuration": 2,
      "pcVideoView": 9,
      "mobileVideoView": 7
    },
    {
      "current": "2018-08-02",
      "pcFlowSize": 10,
      "mobileFlowSize": 1000,
      "mobilePlayDuration": 9,
      "pcPlayDuration": 20,
      "pcVideoView": 90,
      "mobileVideoView": 7
    }	
  ]
}

失败返回json(不带jsonp)

{
  "code": 400,
  "status": "error",
  "message": "ptime is too old.",
  "data": ""
}

字段描述

字段名称	描述
current	查询的日期
pcFlowSize	pc端流量
mobileFlowSize	移动端流量
mobilePlayDuration	移动端播放时长
pcPlayDuration	pc端播放时长
pcVideoView	pc端播放量
mobileVideoView	移动端播放量

响应说明

错误代码	message	说明
400	sign can not be empty.	加密串为空
402	illegal cataid.	分类ID错误
400	ptime is too old.	时间戳过期
400	ptime is illegal.	时间戳参数格式不对或者超过当前时间3分钟
400	Could not find user by userid.	userid不存在
400	the sign is not right.	加密串不正确
402	illegal query date.	start日期大于end日期
500	query failed.	后台程序抛异常
200	success	提交成功

PHP请求示例

<?php
header("Content-type: text/html; charset=utf-8");
$userid="用户id";
$dr="this_year";
$cataid="1399488884";
$ptime=time()*1000;//13位
$secretkey="填写secretKey";
$str="cataid=".$cataid."&dr=".$dr."&ptime=".$ptime.$secretkey;

$hash=strtoupper(sha1($str));
$url="http://api.polyv.net/v2/cata/$userid/stats-info?ptime=$ptime&sign=$hash&dr=$dr&cataid=$cataid";
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

$output = curl_exec($ch);
curl_close($ch);
//打印获得的数据
print_r($output);
?>

签名规则：

将非空的请求参数按照参数名字典顺序排列，连接参数名与参数值,并在尾部加上secretkey，生成40位大写SHA1值，作为sign。以下是示例过程：

1、请求参数为

ptime = "1492591990000"
cataid = "1333444444"
format = "json"

2、将请求参数按照参数名字典顺序排列

cataid = "1333444444"
format = "json"
ptime = "1492591990000"

3、连接字符串 连接参数名与参数值,并在尾部加上secretkey（secretkey的值为tIQp4ATe9Z），如下：

cataid=1333444444&format=json&ptime=1492591990000be68715e9455f8d0971a_3tIQp4ATe9Z

4、生成签名sign

50BF9B165630A8047EB1D17D95A469CC51FF754E

POLYV 帮助中心