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

接口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="3OmoLbTlHu";
$str="ptime=$ptime&vids=$vids".$secretkey;
$sign=strtoupper(sha1($str));
$url="http://api.polyv.net/v2/video/$userid/cata-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
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
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...

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

接口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
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

批量获取视频播放次数

接口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
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

查询视频密码

接口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 首发外链
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

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

接口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
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

获取单个视频的问答题目

点击这里查看旧版

接口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
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

获取单个视频的首图

点击这里查看旧版

接口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=参数)

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

获取单个视频信息

点击这里查看旧版

接口URL

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

接口说明

获取用户单条视频记录

支持格式

XML/JSON

请求方式

POST,GET

请求数限制

TRUE

请求参数

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

返回结果

<xml>
    <code>200</code>
    <status>success</status>
    <message>success</message>
    <data>
        <images_b>3828390191/5/38283901913ea95224af2bbd9e990ea5_0_b.jpg</images_b>
        <images_b>3828390191/5/38283901913ea95224af2bbd9e990ea5_1_b.jpg</images_b>
        <images_b>3828390191/5/38283901913ea95224af2bbd9e990ea5_2_b.jpg</images_b>
        <images_b>3828390191/5/38283901913ea95224af2bbd9e990ea5_3_b.jpg</images_b>
        <images_b>3828390191/5/38283901913ea95224af2bbd9e990ea5_4_b.jpg</images_b>
        <images_b>3828390191/5/38283901913ea95224af2bbd9e990ea5_5_b.jpg</images_b>
        <images>3828390191/5/38283901913ea95224af2bbd9e990ea5_0.jpg</images>
        <images>3828390191/5/38283901913ea95224af2bbd9e990ea5_1.jpg</images>
        <images>3828390191/5/38283901913ea95224af2bbd9e990ea5_2.jpg</images>
        <images>3828390191/5/38283901913ea95224af2bbd9e990ea5_3.jpg</images>
        <images>3828390191/5/38283901913ea95224af2bbd9e990ea5_4.jpg</images>
        <images>3828390191/5/38283901913ea95224af2bbd9e990ea5_5.jpg</images>
        <tag></tag>
        <mp4>http://mpv.videocc.net/3828390191/5/38283901913ea95224af2bbd9e990ea5_1.mp4</mp4>
        <title>0001.优酷网-【经典回顾】加州旅馆 2004版 中英字幕 老鹰乐队[超清版]-0003</title>
        <df>3</df>
        <times>0</times>
        <vid>38283901913ea95224af2bbd9e990ea5_3</vid>

        <mp4_1>http://mpv.videocc.net/3828390191/5/38283901913ea95224af2bbd9e990ea5_1.mp4</mp4_1>
        <mp4_2>http://mpv.videocc.net/3828390191/5/38283901913ea95224af2bbd9e990ea5_2.mp4</mp4_2>
        <mp4_3>http://mpv.videocc.net/3828390191/5/38283901913ea95224af2bbd9e990ea5_3.mp4</mp4_3>
        <cataid>1</cataid>
        <swf_link>http://player.polyv.net/videos/38283901913ea95224af2bbd9e990ea5_3.swf</swf_link>
        <status>61</status>
        <seed>0</seed>
        <flv1>http://plvod01.videocc.net/3828390191/5/38283901913ea95224af2bbd9e990ea5_1.flv</flv1>
        <flv2>http://plvod01.videocc.net/3828390191/5/38283901913ea95224af2bbd9e990ea5_2.flv</flv2>
        <flv3>http://plvod01.videocc.net/3828390191/5/38283901913ea95224af2bbd9e990ea5_3.flv</flv3>
        <sourcefile></sourcefile>
        <playerwidth>600</playerwidth>
        <default_video>http://plvod01.videocc.net/3828390191/5/38283901913ea95224af2bbd9e990ea5_3.flv</default_video>
        <duration>00:02:01</duration>
        <first_image>http://img.videocc.net/uimage/3/3828390191/first_image/a15c4fe5-9fdc-4a38-adc0-2e6097757fbb_s.jpg</first_image>
        <original_definition>1104x622</original_definition>
        <context></context>
        <playerheight>337</playerheight>
        <ptime>2017-04-25 11:35:06</ptime>
        <source_filesize>22502693</source_filesize>
        <filesize>4755814</filesize>
        <filesize>8694257</filesize>
        <filesize>21784017</filesize>
        <md5checksum>8c6a35b5e92f84437c56de6f40b39973</md5checksum>
        <hls>http://hls.videocc.net/3828390191/3/38283901913ea95224af2bbd9e990ea5_1.m3u8</hls>
        <hls>http://hls.videocc.net/3828390191/3/38283901913ea95224af2bbd9e990ea5_2.m3u8</hls>
        <hls>http://hls.videocc.net/3828390191/3/38283901913ea95224af2bbd9e990ea5_3.m3u8</hls>
        <previewVid>v63c44pl69mnc04m6l6512ck4468m41cl_6</previewVid>
    </data>
</xml>

JSON示例

{
code: 200,
status: "success",
message: "success",
data: [
{
images_b: [
"36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_0_b.jpg",
"36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_1_b.jpg",
"36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_2_b.jpg",
"36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_3_b.jpg",
"36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_4_b.jpg",
"36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_5_b.jpg"
],
images: [
"36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_0.jpg",
"36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_1.jpg",
"36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_2.jpg",
"36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_3.jpg",
"36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_4.jpg",
"36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_5.jpg"
],
imageUrls: [
"http://img.videocc.net/uimage/3/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_0.jpg",
"http://img.videocc.net/uimage/3/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_1.jpg",
"http://img.videocc.net/uimage/3/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_2.jpg",
"http://img.videocc.net/uimage/3/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_3.jpg",
"http://img.videocc.net/uimage/3/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_4.jpg",
"http://img.videocc.net/uimage/3/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_5.jpg"
],
tag: "标签",
mp4: "http://mpv.videocc.net/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_1.mp4",
title: "upload上传视频",
df: 2,
times: "0",
vid: "36e77ba39cfe07c3a3812ed7735c71ea_3",
mp4_1: "http://mpv.videocc.net/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_1.mp4",
mp4_2: "http://mpv.videocc.net/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_2.mp4",
cataid: "1",
swf_link: "http://player.polyv.net/videos/36e77ba39cfe07c3a3812ed7735c71ea_3.swf",
status: "61",
seed: 1,
flv1: "http://plvod01.videocc.net/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_1.plv",
flv2: "http://plvod01.videocc.net/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_2.plv",
sourcefile: "",
playerwidth: "600",
default_video: "http://plvod01.videocc.net/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_1.plv",
duration: "00:00:33",
first_image: "http://img.videocc.net/uimage/3/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_0.jpg",
original_definition: "672x378",
context: "视频文档描述",
playerheight: "490",
ptime: "2017-12-04 09:41:10",
source_filesize: 2295887,
filesize: [
1273674,
2262596
],
md5checksum: "44b145c6bea7dd826191990dfb38d1fd",
hls: [
"http://hls.videocc.net/36e77ba39c/3/36e77ba39cfe07c3a3812ed7735c71ea_1.m3u8",
"http://hls.videocc.net/36e77ba39c/3/36e77ba39cfe07c3a3812ed7735c71ea_2.m3u8"
],
tsfilesize1: "1459696",
tsfilesize2: "2528832",
tsfilesize3: "0",
previewVid: "263c44pl69mnc04m6l6512ck4468m41cl_6"
}
]
}
)

失败返回json(不带jsonp)

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

字段说明

字段 说明
error 错误提示
swf_link 返回flash连接
tag 视频标签
mp4 MP4源文件
playerwidth 视频宽度
title 标题
duration 时长
filesize 编码后各个清晰度视频的文件大小(单位:字节),类型为array
first_image 视频首图
times 播放次数
context 视频描述
original_definition 最佳分辨率
images 视频截图
playerheight 视频高度
ptime 视频上传日期
context 内容
ptime 上传时间
vid 视频id
previewVid 预览视频id
cataid 分类id, 如1为根目录
default_video 用户默认播放视频
df 视频码率数
flv1 流畅码率flv格式视频地址
flv2 高清码率flv格式视频地址
flv3 超清码率flv格式视频地址
mp4_1 流畅码率mp4格式视频地址
mp4_2 高清码率mp4格式视频地址
mp4_3 超清码率mp4格式视频地址
hlsIndex 索引文件,记录每个清晰度的m3u8的链接
hls_1 流畅清晰度的m3u8
hls_2 高清清晰度的m3u8
hls_3 超清清晰度的m3u8
images_b 视频截图大图地址
seed 加密视频为1,非加密为0
status 视频状态
视频状态码 含义
60/61 已发布
10 等待编码
20 正在编码
50 等待审核
51 审核不通过
-1 已删除

PHP请求示例

<?php
header("Content-type: text/html; charset=utf-8");
$userid="3828390191";
$format="json";
$jsonp="";//(注意如果这里如果没有jsonp,则不需要拼接&jsonp=参数)
$ptime=time()*1000;//13位
$vid="382839019131be68715e9455f8d0971a_3";
$secretkey="tIQp4ATe9Z";
if (empty($jsonp)) {
    $str="format=".$format."&ptime=".$ptime."&vid=".$vid.$secretkey;
}else{
    $str="format=".$format."&jsonp=".$jsonp."&ptime=".$ptime."&vid=".$vid.$secretkey;
}
//echo $str.'';
$hash=strtoupper(sha1($str));
//echo $hash.'';
$url="http://api.polyv.net/v2/video/{$userid}/get-video-msg";
$post_data = array (
    "format" => $format,
    "jsonp" => $jsonp,
    "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://v.polyv.net/uc/examlog/list?vid=$vid

接口说明

获取单个视频的答题日志

支持格式

JSON

HTTP请求方式

POST, GET

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
vid true string 视频ID

返回错误列表

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

JSON示例

[
{
"logid": 119381,
"examId": "1487c38a9a2",
"userid": "d81a899efa",
"videoPoolId": "d81a899efacff6e71492cd4eaaff5e73_d",
"question": "阅读理解的第一个步骤是?",
"answer": "[\"B.速读短文\"]",
"isCorrect": 1,
"playId": "1411791245147629321",
"ipAddress": "14.18.236.66",
"province": "广东省",
"isp": "电信",
"operatingSystem": "Windows 7",
"browser": "Chrome",
"dateAdded": 1411796209000
},
{
"logid": 119409,
"examId": "1487c38a9a2",
"userid": "d81a899efa",
"videoPoolId": "d81a899efacff6e71492cd4eaaff5e73_d",
"question": "阅读理解的第一个步骤是?",
"answer": "[\"B.速读短文\"]",
"isCorrect": 1,
"playId": "1411799817614676332",
"ipAddress": "14.18.236.66",
"province": "广东省",
"isp": "电信",
"operatingSystem": "Windows 7",
"browser": "Chrome",
"dateAdded": 1411799888000
}
]

字段说明

字段 说明
logid 日志的id
examId 问答题目的id
userid 用户的id
videoPoolId 视频的id
question 问题
answer 答案
isCorrect 回答是否正确
playId 播放视频时产生的播放session的id
ipAddress IP地址
province 省份
isp 互联网服务提供商
operationSystem 操作系统
browser 浏览器
dateAdded 日志创建时间
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...