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

接口URL

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

接口说明

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

支持格式

JSON

请求方式

GET

请求参数

参数名 必选 类型及范围 说明
ptime true string 当前时间的毫秒级时间戳(13位),30分钟内有效
sign true string 签名
userid true string 用户id(拼接在url,无需另外传参数)
playauth true number 是否开启(开启为1,没开启为0)
numPerPage false int 每页取多少条数据(默认为99)
pageNum false int 取第几页(默认为1)

注意事项

所有有值的参数,按照字母排序方式以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": "200",
  "message": "195",
  "data": [
    {
      "duration": "00:02:28",
      "vid": "8l8v64820da93146cfb86697d90c7f63_8",
      "date": "2017-11-17 14:39",
      "uploader": "主账号",
      "cataid": "1490846401832",
      "sourceFileSize": "15.95 MB",
      "firstImage": "http://img.videocc.net/uimage/8/8l8v64820d/3/8l8v64820da93146cfb86697d90c7f63_0.jpg",
      "cataname": "4",
      "title": "d带宽s(1).mp4",
      "status": "审核不通过"
    },
    {
      "duration": "00:00:02",
      "vid": "8l8v64820d40d49375523f393bfa53aa_8",
      "date": "2017-11-17 14:04",
      "uploader": "主账号",
      "cataid": "1494991264900",
      "sourceFileSize": "225.08 KB",
      "firstImage": "http://img.videocc.net/uimage/8/8l8v64820d/a/8l8v64820d40d49375523f393bfa53aa_0.jpg",
      "cataname": "<script>alert()</script>",
      "title": "pt_1450256414551.mp4",
      "status": "已发布"
    },
    {
      "duration": "00:59:54",
      "vid": "8l8v64820d727ad8dcbd74c53d4e47d6_8",
      "date": "2017-10-11 11:42",
      "uploader": "主账号",
      "cataid": "1461120809847",
      "sourceFileSize": "227.61 MB",
      "firstImage": "http://img.videocc.net/uimage/8/8l8v64820d/6/8l8v64820d727ad8dcbd74c53d4e47d6_5.jpg",
      "cataname": "uu",
      "title": "wKjJ0VZ6d6zxwMtWCNCEmYWT2wk757",
      "status": "已发布"
    },
    {
      "duration": "00:01:14",
      "vid": "8l8v64820df4e2f48bd5d9b65690c9d4_8",
      "date": "2017-07-20 14:50",
      "uploader": "主账号",
      "cataid": "1407743526800",
      "sourceFileSize": "23.57 MB",
      "firstImage": "http://img.videocc.net/uimage/8/8l8v64820d/4/8l8v64820df4e2f48bd5d9b65690c9d4_5.jpg",
      "cataname": "广告分类11111111111111111111",
      "title": "1122daffd",
      "status": "已发布"
    },
    {
      "duration": "00:05:05",
      "vid": "8l8v64820dcad904c482b2edba9be34f_8",
      "date": "2017-11-01 11:31",
      "uploader": "API",
      "cataid": "1407743526800",
      "sourceFileSize": "38.42 MB",
      "firstImage": "http://img.videocc.net/uimage/8/8l8v64820d/f/8l8v64820dcad904c482b2edba9be34f_0.jpg",
      "cataname": "广告分类11111111111111111111",
      "title": "朴树 - 平凡之路-test.mkv",
      "status": "已发布"
    }
  ]
}

返回结果data表示成功修改的数量.

字段说明

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

响应代码与响应信息对应

code message data 说明
400 sign can not be empty. 加密串为空
400 ptime is too old. 时间戳过期
400 ptime is illegal. ptime超出当前时间3分钟
400 Could not find user by userid. userid不存在
400 the sign is not right. 加密串错误
500 查询失败. 后台抛异常
200 视频列表的总数 分页查询到的视频列表 查询成功

PHP示例代码

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

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

"playauth" = "1"
"ptime" = "1493188350000"

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

playauth=1&ptime=1493188350000tIQp4ATe9Z

4、生成签名sign

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

按标题查找视频

点击这里查看旧版

接口URL

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

接口说明

按视频标题查询视频列表

支持格式

XML/JSON

请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
userid true string 用户的id
format false string 默认返回json格式,如果format=xml返回xml格式
jsonp false string 例如,正常情况{error:0,data:””},加 jsonp=a后返回a({error:0,data:””})
keyword false string 视频标题
numPerPage false int 每页显示数量
pageNum false int 页码
ptime true string 13位当前时间的毫秒级时间戳

返回结果

<xml>
    <code>200</code>
    <status>success</status>
    <message>success</message>
    <data>
        <tag></tag>
        <mp4>http://mpv.videocc.net/7d26575efe/f/7d26575efe097ad66523d19b094c8a8f_1.mp4</mp4>
        <title>Wildlife</title>
        <df>3</df>
        <times>30</times>
        <vid>7d26575efe097ad66523d19b094c8a8f_7</vid>
        <mp4_1>http://mpv.videocc.net/7d26575efe/f/7d26575efe097ad66523d19b094c8a8f_1.mp4</mp4_1>
        <mp4_2>http://mpv.videocc.net/7d26575efe/f/7d26575efe097ad66523d19b094c8a8f_2.mp4</mp4_2>
        <mp4_3>http://mpv.videocc.net/7d26575efe/f/7d26575efe097ad66523d19b094c8a8f_3.mp4</mp4_3>
        <cataid>1491449370131</cataid>
        <swf_link>http://player.polyv.net/videos/7d26575efe097ad66523d19b094c8a8f_7.swf</swf_link>
        <status>61</status>
        <seed>1</seed>
        <playerwidth>600</playerwidth>
        <duration>00:00:30</duration>
        <first_image>http://img.videocc.net/uimage/7/7d26575efe/f/7d26575efe097ad66523d19b094c8a8f_5.jpg</first_image>
        <original_definition>1280x720</original_definition>
        <context></context>
        <playerheight>337</playerheight>
        <ptime>2017-04-06 15:23:36</ptime>
        <source_filesize>26246026</source_filesize>
        <filesize>1272725</filesize>
        <filesize>2279413</filesize>
        <filesize>5108761</filesize>
        <md5checksum>d8c2eafd90c266e19ab9dcacc479f8af</md5checksum>
        <hls>http://hls.videocc.net/7d26575efe/7/7d26575efe097ad66523d19b094c8a8f_1.m3u8</hls>
        <hls>http://hls.videocc.net/7d26575efe/7/7d26575efe097ad66523d19b094c8a8f_2.m3u8</hls>
        <hls>http://hls.videocc.net/7d26575efe/7/7d26575efe097ad66523d19b094c8a8f_3.m3u8</hls>
    </data>
</xml>

JSON示例

{
    code: 200,
    status: "success",
    message: "success",
    data: [{
        tag: "",
        mp4: "http://mpv.videocc.net/7d26575efe/f/7d26575efe097ad66523d19b094c8a8f_1.mp4",
        title: "Wildlife",
        df: 3,
        times: "30",
        vid: "7d26575efe097ad66523d19b094c8a8f_7",
        mp4_1: "http://mpv.videocc.net/7d26575efe/f/7d26575efe097ad66523d19b094c8a8f_1.mp4",
        mp4_2: "http://mpv.videocc.net/7d26575efe/f/7d26575efe097ad66523d19b094c8a8f_2.mp4",
        mp4_3: "http://mpv.videocc.net/7d26575efe/f/7d26575efe097ad66523d19b094c8a8f_3.mp4",
        cataid: "1491449370131",
        swf_link: "http://player.polyv.net/videos/7d26575efe097ad66523d19b094c8a8f_7.swf",
        status: "61",
        seed: 1,
        playerwidth: "600",
        duration: "00:00:30",
        first_image: "http://img.videocc.net/uimage/7/7d26575efe/f/7d26575efe097ad66523d19b094c8a8f_5.jpg",
        original_definition: "1280x720",
        context: "",
        playerheight: "337",
        ptime: "2017-04-06 15:23:36",
        source_filesize: 26246026,
        filesize: [
            1272725,
            2279413,
            5108761
        ],
        md5checksum: "d8c2eafd90c266e19ab9dcacc479f8af",
        hls: [
            "http://hls.videocc.net/7d26575efe/7/7d26575efe097ad66523d19b094c8a8f_1.m3u8",
            "http://hls.videocc.net/7d26575efe/7/7d26575efe097ad66523d19b094c8a8f_2.m3u8",
            "http://hls.videocc.net/7d26575efe/7/7d26575efe097ad66523d19b094c8a8f_3.m3u8"
        ]
        }]
}

请求失败返回json示例

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

PHP请求示例

<?php
header("Content-type: text/html; charset=utf-8");
$userid="efbb4ae8ac";//必选
$format="";
$jsonp="";
$numPerPage=100;
$pageNum=1;
$ptime=time()*1000;//必选
$keyword="测试";
$secretkey="hbjCVBhnth";
$post_data = array (
    "format" => $format,
    "jsonp" => $jsonp,
    "keyword"=>$keyword,
    "numPerPage" => $numPerPage,
    "pageNum" => $pageNum,
    "ptime" => $ptime,
);
$str="";
foreach ($post_data as $key => $value){
    if (!empty($value)) {
        $str.=$key."=".$value."&";
    }else{
        unset($post_data[$key]);
    }
}
$str=substr($str, 0,strlen($str)-1);
$str.=$secretkey;
// echo $str;
// die();
$hash=strtoupper(sha1($str));
$post_data["sign"] = $hash;
// var_dump($post_data);
// exit();
$url="http://api.polyv.net/v2/video/{$userid}/search";
$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_POSTFIELDS, $post_data);
$output = curl_exec($ch);
curl_close($ch);
print_r($output);
?>

字段说明

字段 说明
code 请求返回状态码
status 请求返回状态
message 请求返回信息
tag 视频标签
mp4 MP4源文件
title 标题
df 视频码率数
times 播放次数
vid 视频id
mp4_1 流畅码率mp4格式视频地址
mp4_2 高清码率mp4格式视频地址
mp4_3 超清码率mp4格式视频地址
cataid 分类id, 如1为根目录
swf_link 返回视频flash链接
status 视频状态码(data中的status)
seed 加密视频为1,非加密为0
playerwidth 视频宽度
duration 时长
first_image 视频首图
original_definition 最佳分辨率
context 视频描述
playerheight 视频高度
ptime 视频上传日期
source_filesize 源视频文件大小
md5checksum 上传到POLYV云平台的视频源文件的MD5值,可以用来校验是否上传错误或完整
hls 流畅、高清、超清清晰度的m3u8
total 视频总数

 

视频状态码 含义
60/61 已发布
10 等待编码
20 正在编码
50 等待审核
51 审核不通过
-1 已删除

sign的生成规则

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

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

按标签查找视频

点击这里查看旧版

接口URL

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

接口说明

按视频标签查找视频列表

支持格式

XML/JSON

请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
userid true string POLYV用户ID,http://api.polyv.net/v2/data/{userid}/viewlog中的{userid}需要替换为POLYV用户ID的值
format false string 默认返回json格式,如果format=xml返回xml格式
jsonp false string 例如,正常情况{error:0,data:””},加 jsonp=a后返回a({error:0,data:””})
numPerPage false int 页数
pageNum false int 页码
ptime true string 当前时间的毫秒级时间戳(13位),3分钟内有效
tag false string 视频标签
sign true string 签名,为40位大写的SHA1值

PHP示例代码

<?php
$userid="9f1e0689e1";//必选
$format="";
$jsonp="";
$numPerPage=100;
$pageNum=1;
$ptime=time()*1000;//必选
$tag="刘诗昆";
$secretkey="AkDipaULWw";
$post_data = array (
    "format" => $format,
    "jsonp" => $jsonp,
    "numPerPage" => $numPerPage,
    "pageNum" => $pageNum,
    "ptime" => $ptime,
    "tag" => $tag
);
$str="";
foreach ($post_data as $key => $value){
    if (!empty($value)) {
        $str.=$key."=".$value."&";
    }else{
        unset($post_data[$key]); 
    }
}
$str=substr($str, 0,strlen($str)-1);
$str.=$secretkey;
// echo $str;
// die();
$hash=strtoupper(sha1($str));
$post_data["sign"] = $hash;
// var_dump($post_data);
// exit();
$url="http://api.polyv.net/v2/video/{$userid}/search";
$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_POSTFIELDS, $post_data);
$output = curl_exec($ch);
curl_close($ch);
print_r($output);
?>

返回结果

<xml>
    <code>200</code>
    <status>success</status>
    <message>success</message>
    <data>
        <tag>刘诗昆,110435</tag>
        <mp4>http://mpv.videocc.net/9f1e0689e1/6/9f1e0689e1a156fc6b373eab9195b0c6_1.mp4</mp4>
        <title>刘诗昆钢琴教程4</title>
        <df>1</df>
        <times>68</times>
        <vid>9f1e0689e1a156fc6b373eab9195b0c6_9</vid>
        <mp4_1>http://mpv.videocc.net/9f1e0689e1/6/9f1e0689e1a156fc6b373eab9195b0c6_1.mp4</mp4_1>
        <cataid>1470122811372</cataid>
        <swf_link>http://player.polyv.net/videos/9f1e0689e1a156fc6b373eab9195b0c6_9.swf</swf_link>
        <status>60</status>
        <seed>0</seed>
        <playerwidth>600</playerwidth>
        <duration>00:35:52</duration>
        <first_image>http://img.videocc.net/uimage/9/9f1e0689e1/6/9f1e0689e1a156fc6b373eab9195b0c6_5.jpg</first_image>
        <original_definition>384x294</original_definition>
        <context></context>
        <playerheight>458</playerheight>
        <ptime>2016-04-28 12:11:10</ptime>
        <source_filesize>65153042</source_filesize>
        <filesize>69789952</filesize>
        <md5checksum>b6dc8cd9ac9f189e5e2efeba8fd62d9b</md5checksum>
        <hls>http://hls.videocc.net/9f1e0689e1/9/9f1e0689e1a156fc6b373eab9195b0c6_1.m3u8</hls>
    </data>
</xml>

JSON示例

{
  "code": 200,
  "status": "success",
  "message": "success",
  "data": [
    {
      "tag": "刘诗昆,110435",
      "mp4": "http://mpv.videocc.net/9f1e0689e1/6/9f1e0689e1a156fc6b373eab9195b0c6_1.mp4",
      "title": "刘诗昆钢琴教程4",
      "df": 1,
      "times": "68",
      "vid": "9f1e0689e1a156fc6b373eab9195b0c6_9",
      "mp4_1": "http://mpv.videocc.net/9f1e0689e1/6/9f1e0689e1a156fc6b373eab9195b0c6_1.mp4",
      "cataid": "1470122811372",
      "swf_link": "http://player.polyv.net/videos/9f1e0689e1a156fc6b373eab9195b0c6_9.swf",
      "status": "60",
      "seed": 0,
      "playerwidth": "600",
      "duration": "00:35:52",
      "first_image": "http://img.videocc.net/uimage/9/9f1e0689e1/6/9f1e0689e1a156fc6b373eab9195b0c6_5.jpg",
      "original_definition": "384x294",
      "context": "",
      "playerheight": "458",
      "ptime": "2016-04-28 12:11:10",
      "source_filesize": 65153042,
      "filesize": [
        69789952
      ],
      "md5checksum": "b6dc8cd9ac9f189e5e2efeba8fd62d9b",
      "hls": [
        "http://hls.videocc.net/9f1e0689e1/9/9f1e0689e1a156fc6b373eab9195b0c6_1.m3u8"
      ]
    }
  ]
}

字段说明

字段 说明
code 返回码
status 返回状态
message 返回信息
total 总数
tag 标签
mp4 mp4格式视频地址
title 标题
df 视频码率数
times 播放次数
vid 视频id
mp4_1 流畅码率mp4格式视频地址
cataid 分类id, 如1为根目录
swf_link 返回flash链接
status 视频状态
seed 加密视频为1,非加密为0
playerwidth 视频宽度
duration 时长
first_image 视频首图
original_definition 最佳分辨率
context 视频描述
playerheight 视频高度
ptime 视频上传日期
source_filesize 源文件大小
filesize 编码后各个清晰度视频的文件大小,类型为array
md5checksum md5校验码
hls m3u8地址

sign的生成规则

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

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