根据分类批量获取视频时长和大小

接口URL

http://api.polyv.net/v2/video/{userid}/getSizeByCata

接口说明

根据分类批量获取该分类下视频的时长和大小

请求方式

GET

支持格式

JSON

请求参数

参数名 必选 类型及范围 说明
vids true string 多个视频ID(逗号分割)
cataid false string 多个分类ID(逗号分割)
sign true string 签名,40位大写的sha1值
ptime true string 当前13位毫秒级时间戳,3分钟内有效

参数使用

当传了vids时,按照vids查询;当仅传cataid时,按照cataid查询;vids和cataid不能同时为空

JSON返回

{
    code: 200,
    status: "success",
    message: "success",
    data: [
        {
            cataid: 1458806129324,
            videos: [
                {
                    vid: "8205ac89d3d5c47690b01f2f08a4c91f_8",
                    duration: "00:03:34",
                    filesize1: 8749719,
                    filesize2: 15676091,
                    filesize3: 35003810
                },
                {
                    vid: "8205ac89d30d552b2f188c94515f4db6_8",
                    duration: "00:00:37",
                    filesize1: 1360064,
                    filesize2: 3229714,
                    filesize3: 4606271
                }
            ]
        }
    ]
}

返回错误json

{
    "code":400,
    "status":"error",
    "message":"sign can not be empty.",
    "data":""
}

PHP示例代码

<?php
$userid="2d939377c2";
$vids="2d939377c23a37d2b0a2428006755627_2,2d939377c23ebcfe8b4ff3dadcabfbbf_2";
$ptime=time()*1000;
$secretkey="txQQKe3ITY";
$str="ptime=$ptime&vids=$vids".$secretkey;
$sign=strtoupper(sha1($str));
$url="http://api.polyv.net/v2/video/$userid/getSizeByCata?ptime=$ptime&sign=$sign&vids=$vids";
$content = file_get_contents($url);
echo $content;
?>

签名规则:

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

  • 请求参数为
"ptime" = "1493344799000"
"vids" = "2d939377c23a37d2b0a2428006755627_2,2d939377c23ebcfe8b4ff3dadcabfbbf_2"
  • 将请求参数按照参数名字典顺序排列
"ptime" = "1493344799000"
"vids" = "2d939377c23a37d2b0a2428006755627_2,2d939377c23ebcfe8b4ff3dadcabfbbf_2"
  • 连接字符串
    连接参数名与参数值,并在尾部加上secretkey(secretkey的值为3OmoLbTlHu),如下:
ptime=1493344799000&vids=2d939377c23a37d2b0a2428006755627_2,2d939377c23ebcfe8b4ff3dadcabfbbf_23OmoLbTlHu
  • 生成签名sign
66A7000F442DB7D701533C69F44053521D17C7D0
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

上传多个视频的预览图URL

接口URL

http://api.polyv.net/v2/video/{userid}/uploadCoverImageUrl

接口说明

将url地址对应的图片更换到视频预览图上,图片资源不支持https的协议

支持格式

JSON

请求方式

POST

请求参数

参数名 必选 类型及范围 说明
ptime true string 当前时间的毫秒级时间戳(13位),30分钟内有效
userid true string 用户id(拼接在url,无需另外传参数)
sign true string 签名
vids false string 多个视频id用逗号隔开
cataids false string 多个分类id用逗号隔开
fileUrl true string 图片url地址

参数使用:

当传了vids参数,以vids为准,当vids不传,以cataids为准,两个参数不能同时为空。

注意事项

所有有值的参数,按照字母排序方式以key=value&key=value的格式串起来,最后拼上secretkey,以SHA-1方式加密并全部大写化。(注意,当参数没有传递,或者传递了空值,sign不需要将此参数计算进去)

例如:api传递了ptime,vid。ptime为1,vid为test1,userid对应用户的secretkey为test2
则sign的值为:ptime=1&vid=test1test2经过SHA-1加密后大写化为: C2B1558D697EA3AF4ED2FC90152751860C1E2163。

返回错误结果JSON示例

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

返回正确结果JSON示例

{
  "code": 200,
  "status": "success",
  "message": "success",
  "data": "上传成功."
}

字段说明

字段 说明
code 返回码
status 返回状态
message 返回信息
data 操作结果

响应代码与响应信息对应

code message 说明
400 sign can not be empty.
400 ptime is too old.
400 ptime is illegal. ptime超出当前时间3分钟
400 Could not find user by userid.
400 the sign is not right.
412 vids不能为空.
413 上传失败. 上传到服务器出错
500 上传失败,请查看日志. 后台抛异常
200 success. 上传成功

php上传示例:

<?php
header("Content-type: text/html; charset=utf-8");
$userid="3828390191";
$vids="382839019131be68715e9455f8d0971a_3";
$fileUrl="http://test.jpg";
$ptime=time()*1000;//13位
$secretkey="tIQp4ATe9Z";
$str="fileUrl=".$fileUrl."&ptime=".$ptime."&vids=".$vids.$secretkey;
//echo $str.'';
$hash=strtoupper(sha1($str));
//echo $hash.'';
$url="http://api.polyv.net/v2/video/{$userid}/uploadCoverImageUrl";
$post_data = array (
    "vids" => $vids,
    "fileUrl" => $fileUrl,
    "ptime" => $ptime,
    "sign" => $hash,
);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
// post数据
curl_setopt($ch, CURLOPT_POST, 1);
// post的变量
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
$output = curl_exec($ch);
curl_close($ch);
//打印获得的数据
print_r($output);
?>

签名规则:

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

1、请求参数为

"ptime" = "1493188350000"
"vid" = "3828390191de2b3fd3467c36187aac08_3"

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

"ptime" = "1493188350000"
"vid" = "3828390191de2b3fd3467c36187aac08_3"

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

ptime=1493188350000&vid=3828390191de2b3fd3467c36187aac08_3tIQp4ATe9Z

4、生成签名sign

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

上传多个视频的预览图

点击这里查看旧版

接口URL

http://api.polyv.net/v2/video/{userid}/uploadCoverImage

接口说明

上传一张本地图片作为多个视频或多个分类的预览图

支持格式

JSON

请求方式

POST

请求参数

参数名 必选 类型及范围 说明
ptime true string 当前时间的毫秒级时间戳(13位),30分钟内有效
userid true string 用户id(拼接在url,无需另外传参数)
sign true string 签名
vids false string 多个视频id用逗号隔开
cataids false string 多个分类id用逗号隔开
image true file 图片

参数使用:

当传了vids参数,以vids为准,当vids不传,以cataids为准,两个参数不能同时为空。

注意事项

所有有值的参数,按照字母排序方式以key=value&key=value的格式串起来,最后拼上secretkey,以SHA-1方式加密并全部大写化。(注意,当参数没有传递,或者传递了空值,sign不需要将此参数计算进去,图片参数也无需算入sign)

例如:api传递了ptime,vid。ptime为1,vid为test1,userid对应用户的secretkey为test2
则sign的值为:ptime=1&vid=test1test2经过SHA-1加密后大写化为: C2B1558D697EA3AF4ED2FC90152751860C1E2163。

返回错误结果JSON示例

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

返回正确结果JSON示例

{
  "code": 200,
  "status": "success",
  "message": "success",
  "data": "上传成功."
}

字段说明

字段 说明
code 返回码
status 返回状态
message 返回信息
data 操作结果

响应代码与响应信息对应

code message 说明
400 sign can not be empty.
400 ptime is too old.
400 ptime is illegal. ptime超出当前时间3分钟
400 Could not find user by userid.
400 the sign is not right.
410 图片不能为空且图片大小不能为0.
411 图片必须为gif,jpg,bmp,png格式.
412 vids不能为空.
413 上传失败. 上传到服务器出错
500 上传失败,请查看日志. 后台抛异常
200 success. 上传成功

表单上传示例:

<form action="http://api.polyv.net/v2/video/3828390191/uploadCoverImage" method="post" enctype='multipart/form-data' >
    vids:<input type="input" id="vids" name="vids" value="test1,test2">
    <!-- 当前毫秒级别的时间戳 -->
    ptime:<input type="input" id="ptime" name="ptime" value="">
    <!-- sign = hex_sha1("cataids="+cataids+"&ptime="+ptime+"&vids="+vids+secretkey).toUpperCase(); 具体规则请看下面的规则 -->
    sign<input type="input" name="sign" id="sign" value="">
    cataids:<input type="input" name="cataids" id="cataids" value="1514863632700">
    文件:<input type="file" name="image" id="image" /><br>
    <input type="submit" value="点击上传"/>
</form>

签名规则:

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

1、请求参数为

"ptime" = "1493188350000"
"vids" = "3828390191de2b3fd3467c36187aac08_3"

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

"ptime" = "1493188350000"
"vids" = "3828390191de2b3fd3467c36187aac08_3"

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

ptime=1493188350000&vids=3828390191de2b3fd3467c36187aac08_3tIQp4ATe9Z

4、生成签名sign

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

远程批量上传视频

接口URL

http://api.polyv.net/v2/video/grab/{userid}/upload/multi

接口说明

批量上传远程视频(异步上传)

支持格式

JSON

请求方式

POST

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
ptime true string 当前13位毫秒级时间戳,3分钟内有效
fileUrl true string 远程文件的http连接(带http://),多个地址间使用英文逗号隔开
title true string 标题,多个标题使用逗号隔开,**标题数量必须和文件地址数量一致 **
cataid false long 设定上传视频的分类,分类的id可以在“视频管理”——“内容分类”中获取,如下图所示。cataid为catatree的最后一个long型的整数,catatree由cataid组成。当cataid值为1时,表示用户上传空间的根目录。
sign true string 签名

JSON示例

{
    code: 200,
    status: "success",
    message: "success",
    data: "成功!"
}

返回错误json

// 文件url不能为空
{
  "code":400,
  "status":"error",
  "message":"FileUrl is null!",
  "data":""
}
// 文件标题不能为空
{
  "code":400,
  "status":"error",
  "message":"Title is null!",
  "data":""
}
// 文件的url个数必须和title个数相同
{
  "code":400,
  "status":"error",
  "message":"FileUrl and title are inconsistent!",
  "data":""
}

PHP示例代码

<?php
  $userid="8205ac89d3";
  $secretkey = "kXmHMLeX6M";
  $ptime=time()*1000;
  $fileUrl="http://a.mp4,http://b.mp4";
  $title="aaa,bbb";
  $cataid="131313";
  $str="cataid=$cataid&fileUrl=$fileUrl&ptime=$ptime&title=$title".$secretkey;
  $sign=strtoupper(sha1($str));
  $url="http://api.polyv.net/v2/video/grab/$userid/upload/multi?cataid=$cataid&fileUrl=$fileUrl&ptime=$ptime&title=$title&sign=$sign";
  $ch = curl_init();
  curl_setopt($ch, CURLOPT_URL, $url);
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
  curl_setopt($ch, CURLOPT_POST, 1);
  curl_setopt ($ch, CURLOPT_CUSTOMREQUEST, "POST");
  $output = curl_exec($ch);
  curl_close($ch);
  print_r($output);
?>

签名规则:

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

1、请求参数为

  "cataid"="131313";
  "fileUrl"="http://a.mp4,http://b.mp4";
  "title"="aaa,bbb";
  "ptime"=1527228607000;

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

  "cataid"="131313";
  "fileUrl"="http://a.mp4,http://b.mp4";
  "ptime"=1527228607000;
  "title"="aaa,bbb";

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

cataid=131313&fileUrl=http://a.mp4,http://b.mp4&ptime=1527228607000&title=aaa,bbbkXmHMLeX6M

4、生成签名sign
生成40位大写SHA1值

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

分页获取视频同步列表

接口URL

http://api.polyv.net/v2/video/grab/{userid}/list

接口说明

分页获取抓取任务列表

支持格式

JSON

请求方式

GET

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
ptime true string 当前13位毫秒级时间戳,3分钟内有效
sign true string 签名,40位大写的sha1值
page true int 页数,默认为1
pageSize true int 每页数目,默认为10

JSON示例

{
code: 200,
status: "success",
message: "",
data: {
pageNumber: 1,
totalItems: 1,
contents: [
{
taskid: "hHepZ2SjlE",
userid: "8205ac89d3",
filename: null,
originalname: "111.csv",
filesize: null,
filepath: null,
fileurl: "http://grab.polyv.net/files/csv/1522286666296.csv",
classifyid: "1",
classifyname: "视频分类(根目录)",
seccesscount: 2,
totalcount: 2,
failcount: 0,
status: "Y",
endtime: 1522286706000,
createtime: 1522286672000
}
],
startRow: 1,
endRow: 1,
firstPage: true,
lastPage: true,
nextPageNumber: 1,
prePageNumber: 1,
totalPages: 1,
limit: 1,
offset: 0
}
}

返回错误json

{
  "code":400,
  "status":"error",
  "message":"TaskId is null!",
  "data":""
}

字段说明

字段 说明
code 返回码
status 返回状态
message 返回信息
data 响应结果集
pageNumber 当前的页数
totalItems 总的条数
contents 查询的结果列表
taskid 抓取任务对应的ID
userid 点播用户的ID
originalname 上传的抓取任务csv文件的标题
fileurl 抓取任务的csv文件地址
seccesscount 抓取成功的数量
totalcount 此任务内总抓取数
failcount 抓取失败的数量
status 抓取任务完成状态
endtime 任务完成时间
createtime 任务创建时间
firstPage 是否为第一页,值为:true/false
lastPage 是否为最后一页,值为:true/false
nextPageNumber 下一页编号
prePageNumber 上一页编号
totalPages 总页数
startRow 当前页第一条记录在总抓取记录中的位置
endRow 当前页最后一条记录在总抓取记录中的位置
limit 当前页抓取任务记录个数

PHP示例代码

<?php
  $userid="8205ac89d3";
  $secretkey = "kXmHMLeX6M";
  $ptime=time()*1000;
  $page=1;
  $str= "page=$page&ptime=$ptime".$secretkey;
  $sign=strtoupper(sha1($str));
  $url="http://api.polyv.net/v2/video/grab/$userid/list?ptime=$ptime&sign=$sign&page=$page";
  $ch = curl_init();
  curl_setopt($ch, CURLOPT_URL, $url);
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
  curl_setopt($ch, CURLOPT_POST, 1);
  curl_setopt ($ch, CURLOPT_CUSTOMREQUEST, "GET");
  $output = curl_exec($ch);
  curl_close($ch);
  print_r($output);
?>

签名规则:

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

1、请求参数为

  "page" = 1;
  "ptime"=1527231353000;

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

  "page" = 1;
  "ptime"=1527231353000;

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

page=1&ptime=1527231353000kXmHMLeX6M

4、生成签名sign
生成40位大写SHA1值

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

移动视频分类接口

接口URL

http://api.polyv.net/v2/cata/{userid}/change

接口说明

移动视频分类

支持格式

JSON

请求方式

POST

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
userid true string POLYV用户ID
cataid true string 需要移动的目录分类id, (id=1,表示默认分类)
destCataid true string 移动到的目录分类id, (id=1,表示默认分类)
ptime true string 当前时间的毫秒级时间戳(13位),3分钟内有效
sign true string 签名,为40位大写的SHA1值

注意事项

sign的拼接规则是:cataid=参数&destCataid=参数&ptime=参数secretkey,再经过SHA-1加密并大写化。
这里要注意,如果这些参数的值为空串,则sign里就不用拼上这些变量

PHP示例代码

<?php
header("Content-type: text/html; charset=utf-8");
$userid="XXXXXXXX"; //用户id
$ptime= time()*1000;  //获取当前时间戳
$secretkey = "XXXXXXXX"; //用户对应的secretkey
$cataid = "XXXXXXXXX"; //分类id
$destCataid = "XXXXXXXXX"; //移动到的分类id
$str="cataid=".$cataid."&ptime=".$ptime."&userid=".$userid.$secretkey;
$sign = strtoupper(sha1($str));
$url="http://api.polyv.net/v2/cata/$userid/change?destCataid=$destCataid&cataid=$cataid&sign=$sign&ptime=$ptime";
$ch = curl_init() or die ( curl_error() );
curl_setopt( $ch, CURLOPT_URL, $url);
curl_setopt ($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, 1 );
curl_setopt( $ch, CURLOPT_CONNECTTIMEOUT, 360);
$response = curl_exec ( $ch );
curl_close ( $ch );
echo $response;
?>

返回正确结果JSON示例

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

返回错误结果JSON示例

{
  "code": 400,
  "status": "error",
  "message": "ptime is too old.",
  "data": ""
}
{
  "code": 400,
  "status": "error",
  "message": "cataid为空.",
  "data": ""
}
{
  "code": 402,
  "status": "error",
  "message": "cataid格式出错.",
  "data": ""
}
{
  "code": 402,
  "status": "error",
  "message": "两个cataid不能相同.",
  "data": ""
}
{
  "code": 402,
  "status": "error",
  "message": "不能移动到自己的父亲节点.",
  "data": ""
}

字段说明

字段 说明
code 返回码
status 返回状态
message 返回信息
data 返回的内容
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

批量获取答题日志

接口URL

http://api.polyv.net/v2/video/{userid}/video-exam-log

接口说明

根据指定vid和时间区间查询该时间区域内对应视频下的问答日志,默认每页显示20条记录

支持格式

JSON

请求方式

GET

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
userid true string POLYV用户ID
ptime true string 当前时间的毫秒级时间戳(13位),3分钟内有效
sign true string 签名,为40位大写的SHA1值
vids true string 对应视频的vid,如果是多个视频,将每个vid用英文逗号隔开
pageNum false string 当前页数,默认为1
start false string 查询的开始日期,格式 YYYY-MM-DD
end false string 查询的结束日期,格式 YYYY-MM-DD

签名规则

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

1、请求参数为

"vids" = "vid1,vid2"
"start" = "2012-02-03"
"end" = "2012-09-05"
"pageNum" = "1"
"ptime" = "1493370776000"

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

"end" = "2012-09-05"
"pageNum" = "1"
"ptime" = "1493370776000"
"start" = "2012-02-03"
"vids" = "vid1,vid2"

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

end=2012-09-05&pageNum=1&ptime=1522809252890&start=2012-02-03&vids=vid1,vid23OmoLbTlHu

4、生成签名sign

C6B9BBCF53DCD14F503795A952DCC0ECAFC1AACA

返回正确结果JSON示例

{
  "code": 200,
  "status": "success",
  "message": "success",
  "data": [
    {data: [
        {
        logid: 27595105,
        examId: "161d7dda0e4",
        userid: "8205ac89d3",
        videoPoolId: "8205ac89d31c8c74e462548a2edd7dff_8",
        question: "test(2)",
        answer: "["1"]",
        isCorrect: 0,
        playId: "1519745038760X1487381",
        ipAddress: "61.144.145.7",
        province: "广东省",
        isp: "电信",
        operatingSystem: "Windows 7",
        browser: "Chrome",
        dateAdded: 1519745103000
        }
    ]

返回错误结果JSON示例

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

字段说明

字段 说明
code 返回码
status 返回状态
message 返回信息
data 分类下的视频大小
logid 此条日志的ID
examId 日志所属的问答的ID
userId 用户ID
videoPoolId 问答所属的视频ID
question 问答标题
answer 问答的正确答案
isCorrect 是否回答正确
playerId 播放器ID
ipAddress IP地址
province 省份
isp ISP运营商
operatingSystem 操作系统
browser 浏览器
dateAdded 回答该问题的日期(时间戳形式)

php请求示例

<?php
$userid="efbb4ae8ac";
$vids="8205ac89d31c8c74e462548a2edd7dff_8";//查询月份,格式为yyyyMM
$ptime = time()*1000;
$pageNum=1;
$start="2012-02-01";
$end="2013-03-01";
$secrectKey = "hbjCVBhnth";
$sign=strtoupper(sha1("end=$end&pageNum=$pageNum&ptime=$ptime&start=$start&vids=$vids".$secrectKey));
$url="http://api.polyv.net/v2/video/$userid/video-exam-log?end=$end&ptime=$ptime&sign=$sign&pageNum=$pageNum&start=$start&vids=$vids";
$ch=curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HEADER, 0);
$output = curl_exec($ch);
curl_close($ch);
print_r($output);
?>

响应代码与响应信息对应

code message 说明
400 ptime is illegal. 时间戳格式问题,或者时间戳超过当前时间3分钟
400 请先选择目标视频. vids为空
400 sign can not be empty. 加密串为空
400 ptime is too old. 时间戳过期(3分钟过期)
400 the sign is not right. 加密串错误
400 日期格式错误. start或end格式错误
500 查询出错. 后台发生错误异常
200 success 查询成功
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

提交视频裁剪任务

接口URL

http://api.polyv.net/v2/video/{userid}/clip

接口说明

1、提交视频裁剪的任务
2、{userid}为用户ID
3、接口请求成功会返回裁剪后新视频的vid

支持格式

JSON

请求方式

POST

请求参数

参数名 必选 类型及范围 说明
vid true string 视频ID
ptime true string 当前13位毫秒级时间戳,3分钟内有效
sign true string 签名,40位大写的sha1值
title true string 裁剪后的视频名称
timeFrame true string json格式的特定时间段,格式为[{"start":1,"end":6},{"start":10,"end":16}]. 时间段数量不能超过5个,每个片段开始时间不能大于结束时间,开始与结束时间间隔需要超过或者等于5秒,结束时间不能超过视频的播放时长

返回结果(data里为裁剪出来的视频vid)

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

失败返回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. 加密串不正确
410 vid is blank. vid为空
411 timeFrame is blank. 时间段为空
412 vid doesn't exist. vid不存在
413 illegal timeFrames. timeframe的json格式有问题
414 timeFrames's size exceed 5. timeFrame时间段超过5段
415 illegal timeFrames. timeFrame的结束时间小于开始时间
416 illegal timeFrames. timeFrame时间段长度小于5秒
417 illegal timeFrames. timeFrame的结束时间超过视频的时长
418/419 inital clip task filed. 初始化任务失败,需要查看后台日志原因
500 save clip task failed. 后台程序抛异常
200 success 提交成功

PHP请求示例

<?php
header("Content-type: text/html; charset=utf-8");
$userid="3828390191";
$title="test";
$timeFrame="[{\"end\":12,\"start\":5},{\"end\":35,\"start\":20},{\"end\":82,\"start\":71},{\"end\":195,\"start\":111},{\"end\":236,\"start\":215}]";
$ptime=time()*1000;//13位
$vid="382839019131be68715e9455f8d0971a_3";
$secretkey="tIQp4ATe9Z";
$str="ptime=".$ptime."&timeFrame=".$timeFrame."&title=".$title."&vid=".$vid.$secretkey;
//echo $str.'';
$hash=strtoupper(sha1($str));
//echo $hash.'';
$url="http://api.polyv.net/v2/video/{$userid}/clip";
$post_data = array (
    "timeFrame" => $timeFrame,
    "title" => $title,
    "ptime" => $ptime,
    "vid" => $vid,
    "sign" => $hash,
);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
// post数据
curl_setopt($ch, CURLOPT_POST, 1);
// post的变量
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
$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

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

接口说明

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

支持格式

JSON

请求方式

GET

请求参数

参数名 必选 类型及范围 说明
vid false string 视频ID,不填vid会查所有视频的播放量统计数据
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...

查询视频播放量排行接口

接口URL

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

接口说明

查询视频播放量排行接口

支持格式

JSON

请求方式

GET

请求参数

参数名 必选 类型及范围 说明
userid true string 用户id(在url中使用,请求的时候不需要提交)
ptime true string 当前13位毫秒级时间戳,3分钟内有效
sign true string 签名,40位大写的sha1值
dr false string 时间段,具体值为以下几个:today(今天),yesterday(昨天),7days(最近7天),30days(最近30天),默认值为7days,当start和end都不为空时,dr失效,当start和end其中一个为空,查询最近7天数据,当start和end都为空,以dr为准
start false string 开始日期,格式为yyyy-MM-dd
end false string 结束日期,格式为yyyy-MM-dd

返回结果

{
  "code": 200,
  "status": "success",
  "message": "success",
  "data": {
    "totalMoVideoView": 0,
    "pcVideoDailys": [
      {
        "videoId": "cca90d24f79b99f93f34f7650aaad66f_c",
        "title": "Wildlife",
        "duration": "00:00:30",
        "pcVideoView": 1,
        "mobileVideoView": 0
      },
      {
        "videoId": "cca90d24f7815cedaf40a2c0bbed526c_c",
        "title": "Wildlife",
        "duration": "00:00:30",
        "pcVideoView": 1,
        "mobileVideoView": 0
      },
      {
        "videoId": "cca90d24f7352b354c2b6b335f218d3a_c",
        "title": "",
        "duration": "",
        "pcVideoView": 1,
        "mobileVideoView": 0
      }
    ],
    "moVideoDailys": [
      {
        "videoId": "cca90d24f79b99f93f34f7650aaad66f_c",
        "title": "Wildlife",
        "duration": "00:00:30",
        "pcVideoView": 1,
        "mobileVideoView": 0
      },
      {
        "videoId": "cca90d24f7815cedaf40a2c0bbed526c_c",
        "title": "Wildlife",
        "duration": "00:00:30",
        "pcVideoView": 1,
        "mobileVideoView": 0
      },
      {
        "videoId": "cca90d24f7352b354c2b6b335f218d3a_c",
        "title": "",
        "duration": "",
        "pcVideoView": 1,
        "mobileVideoView": 0
      }
    ],
    "totalPcVideoView": 3
  }
}

失败返回json(不带jsonp)

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

字段描述

字段名称 描述
totalPcVideoView pc端总播放量
totalMoVideoView 移动端总播放量
pcVideoDailys pc端播放量排行列表
moVideoDailys 移动端播放量排行列表
videoId 视频vid
title 视频标题
duration 播放时长
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 start and end illegal. start日期大于end日期
500 query failed. 后台程序抛异常
200 success 提交成功

PHP请求示例

<?php
header("Content-type: text/html; charset=utf-8");
$userid="3828390191";
$dr="7days";
$start="2017-12-30";
$end="2018-03-01";
$ptime=time()*1000;//13位
$secretkey="tIQp4ATe9Z";
//$jsonp="a";
if(empty($jsonp)){
    $str="dr=".$dr."&end=".$end."&ptime=".$ptime."&start=".$start.$secretkey;
}else{
    $str="dr=".$dr."&end=".$end."&jsonp=".$jsonp."&ptime=".$ptime."&start=".$start.$secretkey;
}
echo $str.'';
$hash=strtoupper(sha1($str));
echo $hash.'';
$url="http://api.polyv.net/v2/videoview/$userid/ranklist?ptime=$ptime&sign=$hash&dr=$dr&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...