获取微信分享页的视频相关信息接口

接口URL

http://api.polyv.net/v2/video/wechat-share/{userid}/video-info

接口说明

获取微信分享页的视频相关信息。

支持格式

JSON

请求方式

GET

请求参数

参数名 必选 类型及范围 说明
userid true string 用户id,路径参数
ptime true string 当前13位毫秒级时间戳,3分钟内有效
sign true string 签名,40位大写的sha1值
vid true string 视频id

返回结果

{
  "code": 200,
  "status": "success",
  "message": "success",
  "data": {
    "videoDesc": "<p></p><p style=\"text-align:center;\"><b>test</b></p>",
    "originalPlayTimes": 0,
    "videoCoverImg": "http://img.videocc.net/uimage/8/8205ac89d3/a/8205ac89d3835d52fa9f84752f8386aa_0.jpg",
    "videoIcon": "http://img.videocc.net/uimage/8/8205ac89d3/first_image/9f00cf54-117e-4fc5-932d-4b815717e689_s.jpg",
    "videoTitle": "测试gensee",
    "originalLikeNum": 0
  }
}

失败返回json(不带jsonp)

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

字段描述

字段 说明
videoCoverImg 视频封面图
videoTitle 视频微信分享标题
videoDesc 视频描述
videoIcon 视频图标
originalPlayTimes 初始播放量
originalLikeNum 初始点赞量

响应说明

错误代码 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 vid is blank. vid为空
402 cannot find the video. 找不到视频
500 get video info failed. 后台查询出错

PHP请求示例

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

$hash=strtoupper(sha1($str));
$url="https://api.polyv.net/v2/video/wechat-share/$userid/video-info?ptime=$ptime&sign=$hash&vid=$vid";
$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 = "8205ac89d30adeb51a6f8bf1a1df6f63_8"

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

ptime = "1492591990000"
vid = "8205ac89d30adeb51a6f8bf1a1df6f63_8"

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

ptime=1492591990000&vid=8205ac89d30adeb51a6f8bf1a1df6f63_8tIQp4ATe9Z

4、生成签名sign

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

修改视频广告

接口URL

http://api.polyv.net/v2/advertising/{userid}/edit

接口说明

提供修改广告接口

支持格式

JSON

请求方式

POST

请求参数

参数名 必选 类型及范围 说明
userid true string 用户id,路径参数
ptime true string 当前13位毫秒级时间戳,3分钟内有效
sign true string 签名,40位大写的sha1值
adid true string 广告id
startDate false string 广告开始日期,格式为yyyy-MM-dd
endDate false string 广告结束日期,格式为yyyy-MM-dd
title false string 广告标题
file false file 广告素材,片头、片尾广告素材支持:JPEG,GIF,PNG,FLV,MP4;暂停广告支持:SWF,PNG,JPEG,GIF;弹窗广告支持PNG,JPEG,GIF.
size false int 广告时长
cataids false string 分类id,关联多分类时,以英文逗号(,)分隔
location false int 广告类型,片头-1,暂停-2,片尾-3,弹窗-4
popLocation false int 广告弹窗位置,广告类型为弹窗时必填,右下角-1,右上角-2,左下角-3,左上角-4
popUpTime false int 弹窗出现的时间,单位秒,广告类型为弹窗时必填
status false int 广告状态,已上线-10,待上线-1,已下线-0
upTime false string 广告开始时间,格式为HH:mm:ss,默认为00:00:00
offTime false string 广告结束时间,格式为HH:mm:ss,默认为23:59:59
note false string 广告描述

返回结果

{
  "code": 200, 
  "status": "success", 
  "message": "success", 
  "data": true
}

失败返回json(不带jsonp)

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

响应说明

响应代码 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. 加密串不正确
400 file is empty. 没上传文件或为空文件
400 illegal file type. 非法的文件类型
400 upload file failed. 上传文件失败
400 startDate or endDate error. 日期格式不正确或开始日期大于结束日期
400 upTime or offTime error. 时间格式不正确或开始时间大于结束时间
400 param status can not be empty. 广告状态不能为空
400 title can not be empty. 广告标题不能为空
400 cataids length is not right. 分类数量不正确
400 exist the same cataid. 存在相同的cataid
400 cataid type error. cataid类型错误
400 cata not exist. 分类不存在
400 cata conflict. 不能同时存在父分类和子分类
400 param location error. 广告类型错误
400 param addrurl error. 链接地址错误
400 pop location error. 弹窗位置错误
400 pop up time error. 弹窗出现时间错误
400 admatter is not exist. 广告不存在
400 save fail. 服务器异常导致失败
200 success 提交成功

PHP请求示例

<?php
header("Content-type: text/html; charset=utf-8");
$userid="用户id";
$secretkey="用户secretkey";

$params = array(
    'ptime' => time()*1000,
    'adid' => 'a205e415d05a42ca8d60',
    'title' => '只修改title'
);

# 创建排序后的字典
foreach ($params as $key=>$value){
    $arr[$key] = $key;
}
sort($arr);
$str='';
$length=count($arr);
foreach ($arr as $k => $v) {
    $str = $str.$v.'='.$params[$v];
    if($k < $length-1) {
      $str = $str.'&';
    }
}
$hash=strtoupper(sha1($str.$secretkey));

$params['sign']=$hash;
$url="http://api.polyv.net/v2/advertising/${userid}/edit?".http_build_query($params);
?>
<html>
<form action="<?php echo $url?>" method="post" enctype='multipart/form-data' >
    文件:<input type="file" name="file" id="image" /><br>
    <input type="submit" value="点击上传"/>
</form>
</html>

签名规则:

将非空的请求参数按照参数名字典顺序排列,连接参数名与参数值,并在尾部加上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...

创建视频广告

接口URL

http://api.polyv.net/v2/advertising/{userid}/create

接口说明

提供创建和上传广告素材接口

支持格式

JSON

请求方式

POST

请求参数

参数名 必选 类型及范围 说明
userid true string 用户id,路径参数
ptime true string 当前13位毫秒级时间戳,3分钟内有效
sign true string 签名,40位大写的sha1值
startDate true string 广告开始日期,格式为yyyy-MM-dd
endDate true string 广告结束日期,格式为yyyy-MM-dd
title true string 广告标题
file true file 广告素材,片头、片尾广告素材支持:JPEG,GIF,PNG,FLV,MP4;暂停广告支持:SWF,PNG,JPEG,GIF;弹窗广告支持PNG,JPEG,GIF.
size false int 广告时长,除暂停广告外,都为必填参数
cataids false string 分类id,关联多分类时,以英文逗号(,)分隔,默认值为默认分类("1")
location false int 广告类型,片头-1,暂停-2,片尾-3,弹窗-4;默认为片头
popLocation false int 广告弹窗位置,广告类型为弹窗时必填,右下角-1,右上角-2,左下角-3,左上角-4
popUpTime false int 弹窗出现的时间,单位秒,广告类型为弹窗时必填
status false int 广告状态,已上线-10,待上线-1,已下线-0;默认为已上线
upTime false string 广告开始时间,格式为HH:mm:ss,默认为00:00:00
offTime false string 广告结束时间,格式为HH:mm:ss,默认为23:59:59
note false string 广告描述

返回结果

{
  "code": 200, 
  "status": "success", 
  "message": "success", 
  "data": true
}

失败返回json(不带jsonp)

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

响应说明

响应代码 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. 加密串不正确
400 file is empty. 没上传文件或为空文件
400 illegal file type. 非法的文件类型
400 upload file failed. 上传文件失败
400 startDate or endDate error. 日期格式不正确或开始日期大于结束日期
400 upTime or offTime error. 时间格式不正确或开始时间大于结束时间
400 param status can not be empty. 广告状态不能为空
400 title can not be empty. 广告标题不能为空
400 cataids length is not right. 分类数量不正确
400 exist the same cataid. 存在相同的cataid
400 cataid type error. cataid类型错误
400 cata not exist. 分类不存在
400 cata conflict. 不能同时存在父分类和子分类
400 param location error. 广告类型错误
400 param addrurl error. 链接地址错误
400 pop location error. 弹窗位置错误
400 pop up time error. 弹窗出现时间错误
400 save fail. 服务器异常导致失败
200 success 提交成功

PHP请求示例

<?php
header("Content-type: text/html; charset=utf-8");
$userid="用户id";
$secretkey="用户secretkey";

$params = array(
    'ptime' => time()*1000,
    'title' => 'final',
    'location' => 2,
    'startDate' => '2018-10-18',
    'endDate' => '2018-10-19',
    'cataids' => '1538189764490'
);

# 创建排序后的字典
foreach ($params as $key=>$value){
    $arr[$key] = $key;
}
sort($arr);
$str='';
$length=count($arr);
foreach ($arr as $k => $v) {
    $str = $str.$v.'='.$params[$v];
    if($k < $length-1) {
      $str = $str.'&';
    }
}
$hash=strtoupper(sha1($str.$secretkey));

$params['sign']=$hash;
$url="http://api.polyv.net/v2/advertising/${userid}/create?".http_build_query($params);
?>
<html>
<form action="<?php echo $url?>" method="post" enctype='multipart/form-data' >
    文件:<input type="file" name="file" id="image" /><br>
    <input type="submit" value="点击上传"/>
</form>
</html>

签名规则:

将非空的请求参数按照参数名字典顺序排列,连接参数名与参数值,并在尾部加上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...

获取某分类下某子账号的视频列表

接口URL

http://api.polyv.net/v2/video/{userid}/get-by-uploader

接口说明

查询某个子帐号上传到某个分类的视频列表

支持格式

JSON

请求方式

GET

请求参数

参数名 必选 类型及范围 说明
userid true string 用户id,路径参数
ptime true string 当前13位毫秒级时间戳,3分钟内有效
sign true string 签名,40位大写的sha1值
email false string 子帐号邮箱,默认为查询所有子帐号(不包括主账号)
orderType false int 结果排序类型, 1表示ptime升序,2表示ptime降序,3表示times升序,4表示times降序
cataid false string 分类id,默认为查询所有分类
containSubCata false int 1表示结果包含子分类,0表示结果不包含子分类,默认为0
page false string 第几页,默认查询第1页

返回结果

{
  "code": 200, 
  "status": "success", 
  "message": "success", 
  "data": {
    "pageSize": 20, 
    "pageNumber": 1, 
    "totalItems": 2, 
    "contents": [
      {
        "vid": "b0f7041324d864436f410f581444542a_b", 
        "cataid": 1, 
        "title": "test", 
        "context": "dasdasdadasd", 
        "times": 0, 
        "firstImage": "http://img.videocc.net/uimage/b/b0f7041324/a/b0f7041324d864436f410f581444542a_b.jpg", 
        "tag": "1", 
        "aacLink": null, 
        "status": "61", 
        "uploaderEmail": "test1@zzs.com", 
        "ptime": 1540780829403
      }, 
      {
        "vid": "b0f70413248dbeccef72d9f244278fe1_b", 
        "cataid": 1539918907896, 
        "title": "test", 
        "context": "简介", 
        "times": 0, 
        "firstImage": "http://img.videocc.net/uimage/b/b0f7041324/1/b0f7041324d864436f410f581444542a_b.jpg", 
        "tag": "标签", 
        "aacLink": null, 
        "status": "61", 
        "uploaderEmail": "test1@zzs.com", 
        "ptime": 1540797491063
      }
    ]
  }
}

失败返回json(不带jsonp)

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

字段描述

字段名称 描述
vid 视频vid
cataid 分类id
title 视频标题
context 视频简介
times 播放次数
firstImage 视频首图,封面
tag 标签,以英文逗号(,)分割,没有标签时返回空串
aacLink 音频地址
status 视频状态码
uploaderEmail 子账号邮箱
ptime 上传时间
视频状态码 含义
60/61 已发布
10 等待编码
20 正在编码
50 等待审核
51 审核不通过
-1 已删除

响应说明

响应代码 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. 加密串不正确
400 cata is not exist. 分类不存在
400 child user not exist. 子账号不存在
500 query failed. 后台程序抛异常
200 success 提交成功

PHP请求示例

<?php
header("Content-type: text/html; charset=utf-8");
$userid="用户id";
$secretkey="用户secretkey";

$params = array(
    'ptime' => time()*1000,
    'email' => 'test1@zzs.com',
    'cataid' => '1'
);

# 创建排序后的字典
foreach ($params as $key=>$value){
    $arr[$key] = $key;
}
sort($arr);
$str='';
$length=count($arr);
foreach ($arr as $k => $v) {
    $str = $str.$v.'='.$params[$v];
    if($k < $length-1) {
      $str = $str.'&';
    }
}
$hash=strtoupper(sha1($str.$secretkey));

$params['sign']=$hash;
$url="http://api.polyv.net/v2/video/${userid}/get-by-uploader?".http_build_query($params);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
#curl_setopt($ch, CURLOPT_POST, 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...

获取视频广告列表

接口URL

https://api.polyv.net/v2/advertising/{userId}/list

接口说明

获取广告列表信息。

支持格式

JSON

请求方式

GET

请求参数

参数名 必选 类型及范围 说明
userid true string 用户id,路径参数
ptime true string 当前13位毫秒级时间戳,3分钟内有效
sign true string 签名,40位大写的sha1值
page false string 第几页,默认第一页
pageSize false string 每页显示几条,默认10条

返回结果

{
code: 200,
status: "success",
message: "",
data: {
    "pageNumber":1,
    "totalItems":1,
    "contents":[
        {
        "adid":"b5c5cff59d994d1fa96a",
        "title":"12",
        "note":"",
        "userid":"e8888b74d1",
        "location":"1",
        "matterurl":"/html/adv/video/e/e8888b74d1/thumb/0ffa61de8aa44bf99c447ff4416c4527.mp4",
        "size":5,
        "addrurl":"http://live.polyv.net",
        "isstatis":2,
        "playnum":0,
        "uptime":-25725000,
        "offtime":57078000,
        "startdate":1508256000000,
        "enddate":1508256000000,
        "ptime":1460443912134,
        "status":10,
        "popuptime":null,
        "poplocation":null,
        "cataids":"1",
        "cataname":"视频分类"
        }
    ],
    "totalPages":1,
    "startRow":1,
    "endRow":1,
    "nextPageNumber":1,
    "prePageNumber":1,
    }
}

失败返回json(不带jsonp)

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

字段描述

字段 说明
adid 广告ID
title 广告标题
note 广告描述
userid 用户ID
location 广告类型(片头1, 暂停2,片尾3,弹窗4)
matterurl 广告素材地址
size 广告时长(s)
playnum 播放次数
addrurl 链接地址
isstatis 广告是否悬浮(是为1,不是为2)
uptime 投放开始时间
offtime 投放结束时间
startdate 投放开始日期
enddate 投放结束日期
ptime 修改时间
status 投放状态(已上线10,待下线1,已下线0)
popuptime 弹窗出现时间
cataids 内容分类
poplocation 弹窗位置(右下角1,右上角2,左下角3,左上角4)

响应说明

错误代码 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. 加密串不正确
400 page is illegal page值非法
400 pageSize is illegal pageSize值非法

PHP请求示例

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

$hash=strtoupper(sha1($str));
$url="https://api.polyv.net/v2/advertising/$userid/list?ptime=$ptime&sign=$hash";
$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"

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

ptime = "1492591990000"

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

ptime=1492591990000tIQp4ATe9Z

4、生成签名sign

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

删除视频广告

接口URL

https://api.polyv.net/v2/advertising/{userId}/delete

接口说明

删除单条视频广告。

支持格式

JSON

请求方式

POST

请求参数

参数名 必选 类型及范围 说明
userid true string 用户id,路径参数
ptime true string 当前13位毫秒级时间戳,3分钟内有效
sign true string 签名,40位大写的sha1值
adid true string 广告信息ID

返回结果

{
code: 200,
status: "success",
message: "success",
data: true
}

失败返回json(不带jsonp)

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

字段描述

响应说明

错误代码 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. 加密串不正确
400 adid is empty 广告为空
200 success 提交成功

PHP请求示例

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

$hash=strtoupper(sha1($str));
$url="https://api.polyv.net/v2/advertising/$userid/delete?adid=$adid&ptime=$ptime&sign=$hash";
$curl = curl_init();
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_TIMEOUT, 500);
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_URL, $url);
$res = curl_exec($curl);
curl_close($curl);

echo $res;
?>

签名规则:

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

1、请求参数为

ptime = "1492591990000"
danmuIds = "333,444,556"
format = "json"

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

adid = "333"
ptime = "1492591990000"

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

adid=333&ptime=1492591990000tIQp4ATe9Z

4、生成签名sign

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

查询视频某个时段的播放流量统计数据

接口URL

https://api.polyv.net/v2/traffic/{userid}/video/{vid}

接口说明

查询给定的日期区间内视频每天消耗的流量
自2018年7月10日起,才可以统计到单个视频的移动端流量数据,在此之前没有移动端流量数据

支持格式

JSON

请求方式

GET

请求参数

参数名 必选 类型及范围 说明
userid true string 用户id,路径参数
vid true string 视频vid,路径参数
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
start false string 开始日期,格式为yyyy-MM-dd
end false string 结束日期,格式为yyyy-MM-dd

返回结果

{
  "code": 200, 
  "status": "success", 
  "message": "success", 
  "data": [
    {
      "currentDay": "2018-07-14", 
      "pcFlowSize": 0, 
      "mobileFlowSize": 0, 
      "totalFlowSize": 0
    }, 
    {
      "currentDay": "2018-07-15", 
      "pcFlowSize": 0, 
      "mobileFlowSize": 0, 
      "totalFlowSize": 0
    }, 
    {
      "currentDay": "2018-07-16", 
      "pcFlowSize": 0, 
      "mobileFlowSize": 0, 
      "totalFlowSize": 0
    }, 
    {
      "currentDay": "2018-07-17", 
      "pcFlowSize": 0, 
      "mobileFlowSize": 0, 
      "totalFlowSize": 0
    }, 
    {
      "currentDay": "2018-07-18", 
      "pcFlowSize": 0, 
      "mobileFlowSize": 0, 
      "totalFlowSize": 0
    }, 
    {
      "currentDay": "2018-07-19", 
      "pcFlowSize": 0, 
      "mobileFlowSize": 0, 
      "totalFlowSize": 0
    }, 
    {
      "currentDay": "2018-07-20", 
      "pcFlowSize": 0, 
      "mobileFlowSize": 0, 
      "totalFlowSize": 0
    }
  ]
}

失败返回json(不带jsonp)

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

字段描述

字段名称 描述
currentDay 日期
pcFlowSize PC端消耗流量,单位字节
mobileFlowSize 移动端消耗流量,单位字节
totalFlowSize 总流量消耗,单位字节

响应说明

错误代码 message 说明
400 sign can not be empty. 加密串为空
400 vid invalid. 视频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. 加密串不正确
401 start and end illegal. start日期大于end日期
500 query failed. 后台程序抛异常
200 success 提交成功

PHP请求示例

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

$hash=strtoupper(sha1($str));
$url="https://api.polyv.net/v2/traffic/$userid/video/$vid?ptime=$ptime&sign=$hash&dr=$dr";
$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...

查询单个视频的观看热点统计数据

接口URL

https://api.polyv.net/v2/videohot/{userid}

接口说明

按照日期区间或时间段查询单个视频的观看热点统计数据

支持格式

JSON

请求方式

GET

请求参数

参数名 必选 类型及范围 说明
userid true string 用户id,路径参数
ptime true string 当前13位毫秒级时间戳,3分钟内有效
sign true string 签名,40位大写的sha1值
vid true string 视频vid
dr false string 时间段,具体值为以下几个:today(今天),yesterday(昨天),this_week(本周),last_week(上周),7days(最近7天),this_month(本月),last_month(上个月),this_year(今年),last_year(去年),默认值为7days
start false string 开始日期,格式为yyyy-MM-dd
end false string 结束日期,格式为yyyy-MM-dd

返回结果

{
  "code": 200, 
  "status": "success", 
  "message": "success", 
  "data": [
    {
      "second": 1, 
      "viewcount": 0
    }, 
    {
      "second": 7, 
      "viewcount": 1
    }
  ]
}

失败返回json(不带jsonp)

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

字段描述

字段名称 描述
second 视频时长
viewcount 播放量

响应说明

错误代码 message 说明
400 sign can not be empty. 加密串为空
400 vid invalid. 视频vid错误
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 start and end illegal. start日期大于end日期
500 query failed. 后台程序抛异常
200 success 提交成功

PHP请求示例

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

$hash=strtoupper(sha1($str));
$url="http://api.polyv.net/v2/videohot/$userid?ptime=$ptime&sign=$hash&dr=$dr&vid=$vid";
$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...

查询视频的观看比例统计数据

接口URL

https://api.polyv.net/v2/play-ratio/{userid}

接口说明

查询单个视频或全部视频在一定时间范围内的观看比例统计数据

支持格式

JSON

请求方式

GET

请求参数

参数名 必选 类型及范围 说明
userid true string 用户id,路径参数
ptime true string 当前13位毫秒级时间戳,3分钟内有效
sign true string 签名,40位大写的sha1值
vid false string 视频vid,不填为查询用户维度
dr false string 时间段,具体值为以下几个:today(今天),yesterday(昨天),this_week(本周),last_week(上周),7days(最近7天),this_month(本月),last_month(上个月),this_year(今年),last_year(去年),默认值为7days
start false string 开始日期,格式为yyyy-MM-dd
end false string 结束日期,格式为yyyy-MM-dd

返回结果

{
  "code": 200, 
  "status": "success", 
  "message": "success", 
  "data": [
    {
      "percentage": "0-10", 
      "playCount": 13
    }, 
    {
      "percentage": "10-20", 
      "playCount": 7
    }, 
    {
      "percentage": "20-30", 
      "playCount": 1
    }, 
    {
      "percentage": "30-40", 
      "playCount": 1
    }, 
    {
      "percentage": "40-50", 
      "playCount": 3
    }, 
    {
      "percentage": "50-60", 
      "playCount": 1
    }, 
    {
      "percentage": "60-70", 
      "playCount": 1
    }, 
    {
      "percentage": "70-80", 
      "playCount": 0
    }, 
    {
      "percentage": "80-90", 
      "playCount": 0
    }, 
    {
      "percentage": "90-100", 
      "playCount": 0
    }
  ]
}

失败返回json(不带jsonp)

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

字段描述

字段名称 描述
percentage 观看比例范围
playCount 观看数量

响应说明

错误代码 message 说明
400 sign can not be empty. 加密串为空
400 vid invalid. 视频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. 加密串不正确
401 start and end illegal. start日期大于end日期
500 query failed. 后台程序抛异常
200 success 提交成功

PHP请求示例

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

$hash=strtoupper(sha1($str));
$url="http://api.polyv.net/v2/play-ratio/$userid?ptime=$ptime&sign=$hash&dr=$dr&vid=$vid";
$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...

查询视频的播放时长统计数据

接口URL

https://api.polyv.net/v2/play-duration/{userid}

接口说明

按照日期区间或时段查询视频播放时长统计数据

支持格式

JSON

请求方式

GET

请求参数

参数名 必选 类型及范围 说明
userid true string 用户id,路径参数
ptime true string 当前13位毫秒级时间戳,3分钟内有效
sign true string 签名,40位大写的sha1值
vid false string 视频vid,不传为查询用户级别统计
dr false string 时间段,具体值为以下几个:today(今天),yesterday(昨天),this_week(本周),last_week(上周),7days(最近7天),this_month(本月),last_month(上个月),this_year(今年),last_year(去年),默认值为7days
start false string 开始日期,格式为yyyy-MM-dd
end false string 结束日期,格式为yyyy-MM-dd

返回结果

{
  "code": 200, 
  "status": "success", 
  "message": "success", 
  "data": [
    {
      "currentDay": "2018-07-03", 
      "pcPlayDuration": 260, 
      "formatPcPlayDuration": "00:04:20", 
      "pcPlayDurationVideoAvg": 22, 
      "formatPcPlayDurationVideoAvg": "00:00:22", 
      "pcPlayDurationPersonAvg": 130, 
      "formatPcPlayDurationPersonAvg": "00:02:10", 
      "mobilePlayDuration": 0, 
      "formatMobilePlayDuration": "00:00:00", 
      "mobilePlayDurationVideoAvg": 0, 
      "formatMobilePlayDurationVideoAvg": "00:00:00", 
      "mobilePlayDurationPersonAvg": 0, 
      "formatMobilePlayDurationPersonAvg": "00:00:00"
    }, 
    {
      "currentDay": "2018-07-04", 
      "pcPlayDuration": 0, 
      "formatPcPlayDuration": "00:00:00", 
      "pcPlayDurationVideoAvg": 0, 
      "formatPcPlayDurationVideoAvg": "00:00:00", 
      "pcPlayDurationPersonAvg": 0, 
      "formatPcPlayDurationPersonAvg": "00:00:00", 
      "mobilePlayDuration": 0, 
      "formatMobilePlayDuration": "00:00:00", 
      "mobilePlayDurationVideoAvg": 0, 
      "formatMobilePlayDurationVideoAvg": "00:00:00", 
      "mobilePlayDurationPersonAvg": 0, 
      "formatMobilePlayDurationPersonAvg": "00:00:00"
    }, 
    {
      "currentDay": "2018-07-05", 
      "pcPlayDuration": 0, 
      "formatPcPlayDuration": "00:00:00", 
      "pcPlayDurationVideoAvg": 0, 
      "formatPcPlayDurationVideoAvg": "00:00:00", 
      "pcPlayDurationPersonAvg": 0, 
      "formatPcPlayDurationPersonAvg": "00:00:00", 
      "mobilePlayDuration": 0, 
      "formatMobilePlayDuration": "00:00:00", 
      "mobilePlayDurationVideoAvg": 0, 
      "formatMobilePlayDurationVideoAvg": "00:00:00", 
      "mobilePlayDurationPersonAvg": 0, 
      "formatMobilePlayDurationPersonAvg": "00:00:00"
    }
  ]
}

失败返回json(不带jsonp)

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

字段描述

字段名称 描述
currentDay 日期
pcPlayDuration pc端播放时长,单位秒
formatPcPlayDuration 格式化的pc端播放时长
pcPlayDurationVideoAvg PC端视频平均播放时长,单位秒
formatPcPlayDurationVideoAvg 格式化的PC端视频平均播放时长
pcPlayDurationPersonAvg PC端人均播放时长,单位秒
formatPcPlayDurationPersonAvg 格式化的PC端人均播放时长
mobilePlayDuration 移动端播放时长,单位秒
formatMobilePlayDuration 格式化的移动端播放时长
mobilePlayDurationVideoAvg 移动端视频平均播放时长,单位秒
formatMobilePlayDurationVideoAvg 格式化后的移动端视频平均播放时长
mobilePlayDurationPersonAvg 移动端人均播放时长,单位秒
formatMobilePlayDurationPersonAvg 格式化的移动端人均播放时长

响应说明

错误代码 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 start and end illegal. start日期大于end日期
500 query failed. 后台程序抛异常
200 success 提交成功

PHP请求示例

<?php
header("Content-type: text/html; charset=utf-8");
$userid="用户id";
$start="2018-07-03";
$end="2018-07-05";
$ptime=time()*1000;//13位
$secretkey="secretkey填写";
$str="end=".$end."&ptime=".$ptime."&start=".$start.$secretkey;

$hash=strtoupper(sha1($str));
$url="http://api.polyv.net/v2/play-duration/$userid?ptime=$ptime&sign=$hash&start=$start&end=$end";
$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...