获取某一天视频日志

接口URL

http://api.polyv.net/v2/data/{userid}/viewlog

接口说明

获取某一天视频日志

支持格式

JSON

请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名 必选 类型 说明
userid string POLYV用户ID,http://api.polyv.net/v2/data/{userid}/viewlog中的{userid}需要替换为POLYV用户ID的值
day string 查询某天的日志时间
ptime string 当前时间的毫秒级时间戳(13位),3分钟内有效
sign string 签名,为40位大写的SHA1值
type string 返回的数据格式为:json/xml
vid string 视频ID
cataid string 分类ID,注意视频ID(vid)和分类ID(cataid)不能同时为空;当vid为空、cataid不为空时,查询对应cataid下的日志;当vid不为空时查询对应vid的日志

JSON示例

{
  code: 200,
  status: "success",
  message: "",
  data: [
  {
    playId: "1468389486891X1363716",
    userId: "3828390191",
    videoId: "3828390191ed924fbb387395ae6f3af5_3",
    playDuration: 13,
    stayDuration: 17,
    currentTimes: 14,
    duration: 1551,
    flowSize: 13638592,
    sessionId: "",
    param1: "",
    param2: "",
    param3: "",
    param4: "",
    param5: "160712",
    ipAddress: "120.197.57.62",
    country: "中国",
    province: "广东",
    city: "广州",
    isp: "",
    referer: "http://apollo.polyv.net/front/video/preview?vid=3828390191ed924fbb387395ae6f3af5_3",
    userAgent: "Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/53.0.2767.5 Safari/537.36",
    operatingSystem: "Windows",
    browser: "Chrome",
    isMobile: "N",
    currentDay: "2016-07-13",
    currentHour: 13,
    createdTime: 1468389527000,
    lastModified: 1468389563000
  }
  ]
}

字段说明

字段 说明
playId 表示此次播放动作的ID
userId 用户ID
videoId 视频ID
playDuration 播放时长 (用户观看的总时间 ,例如:18:00开始看一个视频,看到了18:30,这30分钟就是播放时长)
stayDuration 缓存时长
currentTimes 播放时间 (用户观看的最后时间,例如:停止观看视频的时候,进度条最后的分钟数为35分钟,播放时间就是35分钟)
duration 视频总时长
flowSize 流量大小
sessionId 用户自定义参数,如学员ID等
param1/2/3/4/5 POLYV系统参数
ipAddress IP地址
country 国家
province 省份
city 城市
isp ISP运营商
referer 播放视频页面地址
userAgent 用户设备
operatingSystem 操作系统
browser 浏览器
isMobile 是否为移动端
currentDay 日志查询日期 (格式为:yyyy-MM-dd)
currentHour 日志查看时间
createdTime 播放开始时间 (格式为13位的时间戳)
lastModified 日志更新日期 (格式为13位的时间戳)

php请求示例

<?php
    $userid="e2e84a7383";
    $day="20160711";
    $readtoken="JZmdsRB4sD-OdmDKN2Rnm-bsFGj3Fi93";
    $secretkey="7UagtQOq2A";
    $ptime=time()*1000;
    $str="day=$day&ptime=$ptime&userid=$userid".$secretkey;
    $sign=strtoupper(sha1($str));
    $vid="e2e84a73839a7070861257c3612309e1_e";
    $url="http://api.polyv.net/v2/data/$userid/viewlog?day=$day&ptime=$ptime&sign=$sign&type=json&vid=$vid";
    $content = file_get_contents($url);
    echo $content;
?>

签名规则

将请求参数(sign除外)按照参数名字典顺序排列,用“&”连接参数名与参数值,并在最后加上secretkey的值,生成40位大写的SHA1值,作为sign。

以下是示例过程:

1. 将请求参数按照参数名字典顺序排列为:

day="20160711";
ptime="1468982782000";
userid="e2e84a7383";

2. 连接字符串 用“&”连接参数名与参数值,并在最后加上secretkey的值,生成40位大写的SHA1值,作为sign(本示例的值为7UagtQOq2A),如下:

day=20160711&ptime=1468982782000&userid=e2e84a73837UagtQOq2A

3. 生成签名sign

sign为40位大写的SHA1值:

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