查询视频播放量统计数据接口

接口URL

http://api.polyv.net/v2/videoview/{userid}

接口说明

查询视频播放量统计数据接口

支持格式

JSON

请求方式

GET

请求参数

参数名 必选 类型及范围 说明
vid true string 视频ID
userid true string 用户id(在url中使用,请求的时候不需要提交)
ptime true string 当前13位毫秒级时间戳,3分钟内有效
sign true string 签名,40位大写的sha1值
dr false string 时间段,具体值为以下几个:today(今天),yesterday(昨天),this_week(本周),last_week(上周),7days(最近7天),this_month(本月),last_month(上个月),this_year(今年),last_year(去年),默认值为7days
period false string 显示周期,具体为以下几个值:daily(按日显示),weekly(按周显示),monthly(按月显示)。默认值为daily。period的值受限于dr的值,当dr的值为today,yesterday,this_week,last_week,7days时,period只能为daily,当dr的值为this_month,last_month时,period只能为daily或者weekly

返回结果

{
  "code": 200,
  "status": "success",
  "message": "success",
  "data": [
    {
      "currentTime": "2018-02-23",
      "pcVideoView": 0,
      "mobileVideoView": 0
    },
    {
      "currentTime": "2018-02-24",
      "pcVideoView": 0,
      "mobileVideoView": 0
    },
    {
      "currentTime": "2018-02-25",
      "pcVideoView": 23,
      "mobileVideoView": 0
    },
    {
      "currentTime": "2018-02-26",
      "pcVideoView": 63,
      "mobileVideoView": 2
    },
    {
      "currentTime": "2018-02-27",
      "pcVideoView": 11,
      "mobileVideoView": 0
    },
    {
      "currentTime": "2018-02-28",
      "pcVideoView": 6,
      "mobileVideoView": 0
    },
    {
      "currentTime": "2018-03-01",
      "pcVideoView": 0,
      "mobileVideoView": 0
    }
  ]
}

失败返回json(不带jsonp)

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

字段描述

字段名称 描述
currentTime 日期
pcVideoView pc端播放量
mobileVideoView 移动端播放量

响应说明

错误代码 message 说明
400 sign can not be empty. 加密串为空
400 ptime is too old. 时间戳过期
400 ptime is illegal. 时间戳参数格式不对或者超过当前时间3分钟
400 Could not find user by userid. userid不存在
400 the sign is not right. 加密串不正确
401 illegal vid. vid格式不正确,正确vid格式前面一段是userid
402 illegal period. period的值非法,请看请求参数里period的限制内容
500 query failed. 后台程序抛异常
200 success 提交成功

PHP请求示例

<?php
header("Content-type: text/html; charset=utf-8");
$userid="3828390191";
$dr="7days";
$period="daily";
$ptime=time()*1000;//13位
$vid="382839019131be68715e9455f8d0971a_3";
$secretkey="tIQp4ATe9Z";
//$jsonp="a";
if(empty($jsonp)){
    $str="dr=".$dr."&period=".$period."&ptime=".$ptime."&vid=".$vid.$secretkey;
}else{
    $str="dr=".$dr."&jsonp=".$jsonp."&period=".$period."&ptime=".$ptime."&vid=".$vid.$secretkey;
}
echo $str.'';
$hash=strtoupper(sha1($str));
echo $hash.'';
$url="http://api.polyv.net/v2/videoview/$userid?vid=$vid&ptime=$ptime&sign=$hash&dr=$dr&period=$period";
$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"
vid = "382839019131be68715e9455f8d0971a_3"
format = "json"

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

format = "json"
ptime = "1492591990000"
vid = "382839019131be68715e9455f8d0971a_3"

3、连接字符串
连接参数名与参数值,并在尾部加上secretkey(secretkey的值为tIQp4ATe9Z),如下:

format=json&ptime=1492591990000&vid=382839019131be68715e9455f8d0971a_3tIQp4ATe9Z

4、生成签名sign

50BF9B165630A8047EB1D17D95A469CC51FF754E
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...