视频信息 | 保利威帮助中心

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

2018年11月9日由郑新越发表

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

以上内容是否对您有帮助？ 根本没有帮助

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

2018年5月31日由张海林发表

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

以上内容是否对您有帮助？ 根本没有帮助

批量获取答题日志

2018年4月20日由张海林发表

接口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": [
    {
      "logid": 155406853, 
      "examId": "168641090ee", 
      "userid": "b0f7041324", 
      "videoPoolId": "b0f704132437d4d493674ddddd702c71_b", 
      "question": "问题", 
      "answer": "[\"A\"]", 
      "isCorrect": 1, 
      "playId": "1551146109426X1318204", 
      "ipAddress": "14.25.159.221", 
      "province": "广东省", 
      "isp": "电信", 
      "operatingSystem": "Windows", 
      "browser": "Chrome", 
      "dateAdded": 1551368821000, 
      "viewerid": "123"
    }
  ]
}

返回错误结果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	回答该问题的日期（时间戳形式）
viewerid	自定义用户id

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	查询成功

以上内容是否对您有帮助？ 根本没有帮助

根据视频vid查询视频的授权播放开关状态

2017年12月21日由郑新越发表

接口URL

http://api.polyv.net/v2/video/{userid}/authplay-status

接口说明

根据视频vid获取视频的授权播放开关状态

支持格式

JSON

请求方式

GET

请求参数

参数名	必选	类型及范围	说明
ptime	true	string	当前时间的毫秒级时间戳（13位），30分钟内有效
userid	true	string	用户id(拼接在url，无需另外传参数)
sign	true	string	签名
vid	true	string	视频id

注意事项

所有有值的参数，按照字母排序方式以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": 1
}

返回结果data为0表示开关关闭，1表示开关开启

字段说明

字段	说明
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.
401	vid为空.
403	用户的视频下找不到该视频.
500	获取失败，请查看后台日志.	后台抛异常
200	success.	查询成功

PHP示例代码

<?php
header("Content-type: text/html; charset=utf-8");
$userid="3828390191";
//$jsonp="a";
$ptime=time()*1000;//13位
$vid="3828390191de2b3fd3467c36187aac08_3";
$secretkey="tIQp4ATe9Z";
if(empty($jsonp)){
    $str="ptime=".$ptime."&vid=".$vid.$secretkey;
}else{
    $str="jsonp=".$jsonp."&ptime=".$ptime."&vid=".$vid.$secretkey;
}
echo $str.'';
$hash=strtoupper(sha1($str));
echo $hash.'';
$url="http://api.polyv.net/v2/video/{$userid}/authplay-status?vid={$vid}&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" = "1493188350000"
"vid" = "3828390191de2b3fd3467c36187aac08_3"

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

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

3、连接字符串
连接参数名与参数值,并在尾部加上secretkey（secretkey的值为tIQp4ATe9Z），如下：

ptime=1493188350000&vid=3828390191de2b3fd3467c36187aac08_3tIQp4ATe9Z

4、生成签名sign

4CE511177FD5A8A3E56EB31A20776C0DE157519A

以上内容是否对您有帮助？ 根本没有帮助

批量获取视频播放次数

2017年7月26日由谢宇鹏发表

接口URL

http://api.polyv.net/v2/data/{userid}/play-times

接口说明

通过多个vid批量获取播放次数。

支持格式

JSON

请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名	必选	类型	说明
vids	true	string	多个视频的vid，用英文逗号隔开
ptime	true	string	13位当前时间毫秒级时间戳
sign	true	string	签名，40位大写的sha1值
realTime	false	string	是否实时,1表示实时，0表示非实时

响应成功JSON示例：

{
  code: 200,
  status: "success",
  message: "success",
  data: [
  {
    vid: "8f8482aaab4b34dec11fdb14b30d71d3_8",
    times: 295
  },
  {
    vid: "8f8482aaab9483da6c818c883643220e_8",
    times: 0
  }
  ]
}

响应失败JSON示例：

{
    "code":400,
    "status":"error",
    "message":"添加失败.",
    "data":""
}

字段说明

参数名	说明
code	返回状态码
status	返回状态值
message	返回信息
data	返回数据
vid	视频vid
times	播放次数

php请求示例

<?php
  header("Content-type: text/html; charset=utf-8");
  $userid="8f8482aaab";
  $realTime="1";
  $vids = "8f8482aaab4b34dec11fdb14b30d71d3_8,8f8482aaab9483da6c818c883643220e_8";
  $ptime= time()*1000;
  $secretkey = "AiDQw1mAmi";
  $str = "ptime=$ptime&realTime=$realTime&vids=$vids".$secretkey;
  $sign = strtoupper(sha1($str));
  $url="http://api.polyv.net/v2/data/{$userid}/play-times";
  $post_data = array (
  "ptime" => $ptime,
      "vids" => $vids,
      "sign" => $sign,
      "realTime" => $realTime,
  );
  $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);
?>

签名规则：

sign生成示例：

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

ptime = "1501055103000"
vids = "8f8482aaab4b34dec11fdb14b30d71d3_8,8f8482aaab9483da6c818c883643220e_8"
realTime = "1"

2、连接字符串连接参数名与参数值,并在尾部加上secretkey（此处secretkey的值为ABIEn1UJht），如下：

ptime=1501055103000&realTime=1&vids=8f8482aaab4b34dec11fdb14b30d71d3_8,8f8482aaab9483da6c818c883643220e_8AiDQw1mAmi

3、sign为40位大写的SHA1值

DC4E9F011DCE46A37711048041D8653A7D30DB17

以上内容是否对您有帮助？ 根本没有帮助

获取单个视频的打点信息

2017年5月24日由谢宇鹏发表

接口URL

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

接口说明

获取单个视频的打点信息

支持格式

JSON

请求方式

GET

请求数限制

TRUE

请求参数

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

JSON示例

{
  code: 200,
  status: "success",
  message: "success",
  data: {
  duration: "00:00:15",
  keyframeList: [
    {
    seconds: 6,
    keyContent: "第一个打点"
    },
    {
    seconds: 10,
    keyContent: "第二个打点"
    },
    {
    seconds: 12,
    keyContent: "第三个打点"
    }
  ]
  }
}

返回错误json

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

字段说明

字段	说明
duration	返回时长
keyframeList	打点信息列表
seconds	打点时间点，单位秒
keyContent	打点详情

PHP示例代码

<?php
$userid="efbb4ae8ac";
$vid="efbb4ae8ac0b8ba3af7af27e3f04db7a_e";
$ptime=time()*1000;
$secrectKey="secrectKey";
$sign=strtoupper(sha1("ptime=".$ptime."&vid=".$vid.$secrectKey));
$url="http://api.polyv.net/v2/video/$userid/keyframe/$vid?ptime=$ptime&sign=$sign";
$ch=curl_init();
curl_setopt($ch,CURLOPT_URL,$url);
curl_setopt($ch,CURLOPT_RETURNTRANSFER,1);
$result=curl_exec($ch);
curl_close($ch);
print_r($result);
?>

签名规则：

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

1、请求参数为

"ptime" = "1495608788000"
"vid" = "efbb4ae8aca0699b6718dc1df84914b5_e"

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

"ptime" = "1495608788000"
"vid" = "efbb4ae8aca0699b6718dc1df84914b5_e"

3、连接字符串
连接参数名与参数值,并在尾部加上secretkey（secretkey的值为hbjCVBhnth），如下：

ptime=1495608788000&vid=efbb4ae8aca0699b6718dc1df84914b5_ehbjCVBhnth

4、生成签名sign

sign=0288334798A81D7FE881C4FAFF65553BF2767C5D

以上内容是否对您有帮助？ 根本没有帮助

查询视频密码

2017年5月8日由张瀚杰发表

接口URL

http://api.polyv.net/v2/video/{userid}/video-setting-page

接口说明

查询视频密码

支持格式

JSON

请求方式

GET

请求数限制

TRUE

请求参数

参数名	必选	类型及范围	说明
userid	true	string	POLYV用户ID，http://api.polyv.net/v2/data/{userid}/viewlog中的{userid}需要替换为POLYV用户ID的值
ptime	true	string	当前时间的毫秒级时间戳（13位），3分钟内有效
vids	true	string	视频ID
sign	true	string	签名，为40位大写的SHA1值

注意事项

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

返回错误列表

返回	说明
0	无错误
1	找不到writetoken关联的user
2	文件为空或者writetoken为空
3	提交的json名字JSONRPC为null
4	提交文件格式不正确
5	readtoken为空
6	分页输入出错
7	vid不能为空
8	找不到方法名

返回结果

// 密码存在data.videoPool.videoPoolExt.password，如果data.videoPool.videoPoolExt不存在密码，则表明密码为空

JSON示例

{
  "code": 200,
  "status": "success",
  "message": "success",
  "data": {
    "questionnaire": {
      "qid": "20160407103005"
    },
    "isShowPassword": false,
    "vids": "9f1e0689e10f2630f8fa8a6a2ae15771_9",
    "videoPool": {
      "describ": "描述",
      "videoPoolExt": {
        "password": "123456"
      },
      "tag": "标签",
      "title": "标题",
      "publishUrl": "my.polyv.net"
    },
    "qid": ""
  }
}

PHP示例代码

<?php
$userid="9f1e0689e1";//必选
$ptime=time()*1000;//13位必选
$vids="9f1e0689e10f2630f8fa8a6a2ae15771_9";//必选
$secretkey="AkDipaULWw";//必选
$str="ptime=".$ptime."&vids=".$vids.$secretkey;
$hash=strtoupper(sha1($str));
$url="http://api.polyv.net/v2/video/{$userid}/video-setting-page"."?ptime=$ptime&vids=$vids&sign=$hash";//只能get
$content=file_get_contents($url);
echo $content;
?>

字段说明

字段	说明
code	返回状态码
status	返回状态值
message	返回信息
isShowPassword	是否显示密码
vids	视频id
describ	视频描述
password	视频密码
tag	视频标签
title	视频标题
publishUrl	首发外链

以上内容是否对您有帮助？ 根本没有帮助

批量获取视频的时长和大小

2017年4月28日由赖志能发表

接口URL

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

接口说明

获取多个视频的时长和大小

请求方式

GET

支持格式

JSON

请求参数

参数名	必选	类型及范围	说明
vids	true	string	多个视频ID(逗号分割)
sign	true	string	签名，40位大写的sha1值
ptime	true	string	当前13位毫秒级时间戳，3分钟内有效
format	false	string	默认返回json格式，如果format=xml返回xml格式
jsonp	false	string	例如，正常情况{error:0,data:””}，加 jsonp=a后返回a({error:0,data:””})

JSON返回

{
code: 200,
status: "success",
message: "success",
data: [
{
vid: "2d939377c23a37d2b0a2428006755627_2",
duration: "00:09:40",
filesize1: 9714032,
filesize2: 9415768
},
{
vid: "2d939377c23ebcfe8b4ff3dadcabfbbf_2",
duration: "00:00:14",
filesize1: 574357,
filesize2: 1092671
}
]
}

返回错误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="3OmoLbTlHu";
$str="ptime=$ptime&vids=$vids".$secretkey;
$sign=strtoupper(sha1($str));
$url="http://api.polyv.net/v2/video/$userid/info?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

以上内容是否对您有帮助？ 根本没有帮助

获取单个视频的问答题目

2017年4月27日由赖志能发表

点击这里查看旧版

接口URL

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

接口说明

获取单个视频的问答题目

支持格式

JSON

HTTP请求方式

POST, GET

请求数限制

TRUE

请求参数

参数名	必选	类型及范围	说明
userid	true	string	用户ID
vid	true	string	视频ID
sign	true	string	签名，40位大写的sha1值
ptime	true	string	当前13位毫秒级时间戳，3分钟内有效
format	false	string	默认返回json格式，如果format=xml返回xml格式
jsonp	false	string	例如，正常情况{error:0,data:””}，加 jsonp=a后返回a({error:0,data:””})

JSON示例

{
  code: 200,
  status: "success",
  message: "success",
  data: [
  {
    examId: "1569b537dcf",
    userid: "2d939377c2",
    videoPoolId: "2d939377c23a37d2b0a2428006755627_2",
    showTime: "0:0:5",
    hours: 0,
    minutes: 0,
    seconds: 5,
    question: "66x6=?",
    choices: "[{"answer":"396","right_answer":1},{"answer":"366"},{"answer":"436"},{"answer":"296"}]",
    answer: "66x6=396",
    wrongTime: -1,
    wrongShow: 1,
    status: 1,
    createdTime: 1493343206000,
    skip: "true",
    type: 0,
    mp3url: "",
    groupId:"0"
  }
  ]
}

返回错误json

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

字段说明

字段	说明
examId	问答题目的id
userid	用户的id
videoPoolId	视频的id
showTime	问答题目开始显示的时间
hours	时
minute	分
seconds	秒
questions	问题
choices	选项
answer	答案
skip	能否跳过问答
wrongTime	回答错误后跳回到第几秒，-1指不退回
wrongShow	回答错误是否提示
createdTime	创建问答题目的时间
groupId	问答所在的问卷的ID

PHP示例代码

<?php
  $userid="2d939377c2";
  $vid="2d939377c23a37d2b0a2428006755627_2";
  $ptime=time()*1000;
  $secretkey="3OmoLbTlHu";
  $str="ptime=$ptime&vid=$vid".$secretkey;
  $sign=strtoupper(sha1($str));
  $url="http://api.polyv.net/v2/video/$userid/get-video-exam?ptime=$ptime&sign=$sign&vid=$vid";
  $content = file_get_contents($url);
  echo $content;
?>

签名规则：

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

以上内容是否对您有帮助？ 根本没有帮助

获取单个视频的首图

2017年4月27日由陈炜彬发表

点击这里查看旧版

接口URL

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

接口说明

获取单个视频的首图

支持格式

JSON

请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名	必选	类型及范围	说明
userid	true	string	用户的id(在请求时不需提交该参数，仅作为接口url中的变量)
ptime	true	float	13位的当前时间毫秒级时间戳
t	false	int	值为1时，表示获取视频首图的缩略图
vid	true	string	视频的id
sign	true	string	签名

请求成功返回json示例

{
  code: 200,
  status: "success",
  message: "success",
  data: "http://img.videocc.net/uimage/7/7d26575efe/6/7d26575efe7af7af4dcaa007d6298196_0.jpg"
}

请求失败返回json示例

{
  code: 400,
  status: "error",
  message: "the sign is not right.",
  data: ""
}

字段说明

字段	说明
code	请求返回的状态码
status	请求返回的状态
message	请求返回的信息
data	请求返回的数据

PHP示例代码

<?php
header("Content-type: text/html; charset=utf-8"); 
$userid="0c4b2b3748";
$ptime=time()*1000;//13位
$t=1;//值为1时，表示获取视频首图的缩略图 false 其他值是大图
$vid="0c4b2b37489e705c0d563cec816d5ab9_0";
$secretkey="l2b58rVt2b";
$str="ptime=".$ptime."&t=".$t."&vid=".$vid.$secretkey;
$hash=strtoupper(sha1($str));
$url="http://api.polyv.net/v2/video/{$userid}/get-image";
$post_data = array (
    "ptime" => $ptime,
    "t" => $t,
    "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);
?>

sign的生成规则

ptime=参数&t=参数&vid=参数secretkey经过SHA-1加密再经过大写化
(注意：参数为空时，则在生成sign的时候不需要添加此字段。例如如果这里没有t，则不需要拼接&t=参数)

以上内容是否对您有帮助？ 根本没有帮助

云直播LIVE

云课堂Cloud Class

云点播VOD

视频私有云Video Private Cloud

PlaySafe®视频版权保护体系

小程序直播

视频防录屏

直播定制服务ODM

直播硬件

在线教育

金融行业

医疗行业

企业培训

活动直播

微信直播

年会直播

软件下载 云直播> 云点播>

使用手册 云直播> 云点播>

开发者中心 云直播> 云点播>

视频教程 云直播> 云点播>

接口URL

接口说明

支持格式

请求方式

请求参数

返回结果

失败返回json(不带jsonp)

字段描述

响应说明

签名规则：

接口URL

接口说明

请求方式

支持格式

请求参数

参数使用

JSON返回

返回错误json

PHP示例代码

签名规则：

接口URL

接口说明

支持格式

请求方式

请求数限制

请求参数

签名规则

返回正确结果JSON示例

返回错误结果JSON示例

字段说明

php请求示例

响应代码与响应信息对应

接口URL

接口说明

支持格式

请求方式

请求参数

注意事项

返回错误结果JSON示例

返回正确结果JSON示例

字段说明

响应代码与响应信息对应

PHP示例代码

签名规则：

接口URL

接口说明

支持格式

请求方式

请求数限制

请求参数

响应成功JSON示例：

响应失败JSON示例：

字段说明

php请求示例

签名规则：

接口URL

接口说明

支持格式

请求方式

请求数限制

PlaySafe^®视频版权保护体系

软件下载云直播> 云点播>

使用手册云直播> 云点播>

开发者中心云直播> 云点播>

视频教程云直播> 云点播>