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

接口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/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
published false int 1表示结果只包含已发布的视频,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/danmu/{userId}/delete

接口说明

批量删除弹幕信息。

支持格式

JSON

请求方式

POST

请求参数

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

返回结果

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

失败返回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. 加密串不正确
500 query failed. 后台程序抛异常
200 success 提交成功

PHP请求示例

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

$hash=strtoupper(sha1($str));
$url="https://api.polyv.net/v2/danmu/$userid/delete?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"
danmuIds = "333,444,556"
format = "json"

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

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

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

damuIds=333,444,556&format=json&ptime=1492591990000tIQp4ATe9Z

4、生成签名sign

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

分页查询用户下所有弹幕信息

接口URL

https://api.polyv.net/v2/danmu/{userId}

接口说明

分页查询用户下所有的弹幕信息。

支持格式

JSON

请求方式

GET

请求参数

参数名 必选 类型及范围 说明
userid true string 用户id,路径参数
ptime true string 当前13位毫秒级时间戳,3分钟内有效
sign true string 签名,40位大写的sha1值
numPerPage false int 单页显示的记录条数
pageNum false int 查询的页数

返回结果

{
code: 200,
status: "success",
message: "success",
data: {
pageNumber: 1,
totalItems: 28,
contents: [
{
id: 43030,
vid: "sl8da4jjbx1c8baed8a48212d735d905_s",
userid: "sl8da4jjbx",
msg: "Iui",
time: "00:00:55",
fontsize: "4294967320",
fontmode: "roll",
fontcolor: "0xFFFFFF",
timestamp: 1529394571000,
sessionid: null,
param2: null
},
{
id: 37470,
vid: "sl8da4jjbx1c8baed8a48212d735d905_s",
userid: "sl8da4jjbx",
msg: "藏族自治州",
time: "00:00:20",
fontsize: "24",
fontmode: "roll",
fontcolor: "0xFFFFFF",
timestamp: 1528106632000,
sessionid: null,
param2: null
}
],
startRow: 1,
endRow: 2,
firstPage: true,
lastPage: false,
nextPageNumber: 2,
prePageNumber: 1,
totalPages: 14,
limit: 2,
offset: 0
}
}

失败返回json(不带jsonp)

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

字段描述

字段名称 描述
id 弹幕信息的唯一标识
vid 视频ID
userid 用户ID
msg 弹幕信息内容
time 弹幕出现的时间点
fontsize 弹幕内容的字体大小
fontmode 弹幕内容滚动方式
fontcolor 弹幕内容字体颜色
timestamp 弹幕内容出现的完整时间戳13位毫秒级
sessionid 自定义参数(不能超过64位的字符串),添加弹幕传入的自定义参数(例如客户自己的用户ID资料等)
param2 自定义参数(不能超过64位的字符串),添加弹幕传入的自定义参数(例如客户自己的用户ID资料等)
pageNumber 当前页
totalItems 总的记录数
totalPages 总的页数

响应说明

错误代码 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. 加密串不正确
500 query failed. 后台程序抛异常
200 success 提交成功

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="http://api.polyv.net/v2/danmu/$userid?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"
format = "json"

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

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

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

format=json&ptime=1492591990000tIQp4ATe9Z

4、生成签名sign

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

删除抓取视频任务

接口URL

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

接口说明

删除抓取视频任务

支持格式

JSON

请求方式

POST

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
ptime true string 当前13位毫秒级时间戳,3分钟内有效
sign true string 签名,40位大写的sha1值
taskId true string 抓取任务ID

JSON示例

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

返回错误json

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

PHP示例代码

<?php
  $userid="8205ac89d3";
  $secretkey = "kXmHMLeX6M";
  $ptime=time()*1000;
  $taskId="o0IdvYDm4S";
  $str="ptime=$ptime&taskId=$taskId".$secretkey;
  $sign=strtoupper(sha1($str));
  $url="http://api.polyv.net/v2/video/grab/$userid/delete?ptime=$ptime&sign=$sign&taskId=$taskId";
  $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、请求参数为

  "ptime"=1527228607000;
  "taskId"="o0IdvYDm4S";

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

  "ptime"=1527228607000;
  "taskId"="o0IdvYDm4S";

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

ptime=1527228607000&taskId=o0IdvYDm4SkXmHMLeX6M

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

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

导出视频同步任务

接口URL

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

接口说明

导出抓取任务列表的csv文件

请求方式

GET

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
ptime true string 当前13位毫秒级时间戳,3分钟内有效
sign true string 签名,40位大写的sha1值
taskId true string 抓取任务ID

返回说明

错误返回json信息 contentType="application/json;charset=UTF-8"

成功返回csv文件
contentType="text/csv;charset=UTF-8"

返回错误json

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

PHP示例代码

<?php
  $userid="8205ac89d3";
  $secretkey = "kXmHMLeX6M";
  $ptime=time()*1000;
  $taskId="hHepZ2SjlE";
  $str = "ptime=$ptime&taskId=$taskId".$secretkey;
  $sign=strtoupper(sha1($str));
  $url="http://api.polyv.net/v2/video/grab/$userid/listVideos/export?ptime=$ptime&sign=$sign&taskId=$taskId";
  echo "<script>location.href='$url'</script>";
?>

签名规则:

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

1、请求参数为

  "ptime"=1527228607000;
  "taskId"="o0IdvYDm4S";

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

  "ptime"=1527228607000;
  "taskId"="o0IdvYDm4S";

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

ptime=1527228607000&taskId=o0IdvYDm4SkXmHMLeX6M

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

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

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

接口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

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...