通过cataid获取视频目录空间

接口URL

http://api.polyv.net/v2/cata/size

接口说明

通过cataid获取视频目录空间

支持格式

JSON

请求方式

GET

请求数限制

TRUE

请求参数

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

注意事项

sign的拼接规则是:cataid=参数&ptime=参数&userid=变量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
$str="cataid=".$cataid."&ptime=".$ptime."&userid=".$userid.$secretkey;
$sign = strtoupper(sha1($str));
$url="http://api.polyv.net/v2/cata/size?userid=$userid&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": 237872181
}

返回错误结果JSON示例

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

字段说明

字段 说明
code 返回码
status 返回状态
message 返回信息
data 分类下的视频大小

响应代码与响应信息对应

code message 说明
400 userid is blank. 用户名为空
400 Could not find user by userid. 用户id不存在
400 the sign is not right. 加密串错误
400 cataid不存在. cataid不存在
400 cataid格式不正确. cataid不是纯数字
500 获取失败. 后台发生错误异常
200 success 查询成功
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

新建视频分类

点击这里查看旧版

接口URL

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

接口说明

新建视频分类

支持格式

JSON

请求方式

POST

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
userid true string 用户ID(在post的时候不需要提交,只用在接口的url中)
cataname true string 分类名称
catatype false string 分类类型
cataurl false string 分类链接
parentid true string 新建的分类目录的上一级目录,值为1时表示根目录
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:””})

JSON示例

{
  code: 200,
  status: "success",
  message: "success",
  data: {
    catatree: "1,1493347765680",
    cataid: 1493347765680
  }
}

返回错误json

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

PHP示例代码

<?php
  $userid="2d939377c2";
  $cataname="新建分类测试";
  $catatype="0";
  $cataurl="分类链接";
  $parentid="1";
  $ptime=time()*1000;
  $secretkey="3OmoLbTlHu";
  $str="cataname=$cataname&catatype=$catatype&cataurl=$cataurl&parentid=$parentid&ptime=$ptime".$secretkey;
  $sign=strtoupper(sha1($str));
  $url="http://api.polyv.net/v2/video/$userid/addCata";
  $post_data = array (
   "cataname" => $cataname,
   "catatype" => $catatype,
   "cataurl" => $cataurl,
   "parentid" => $parentid,
   "ptime" => $ptime,
   "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_POSTFIELDS, $post_data);
  $output = curl_exec($ch);
  curl_close($ch);
  print_r($output);
?>

签名规则:

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

1、请求参数为

"cataname" = "新建分类测试"
"catatype" = "0"
"cataurl" = "分类链接"
"parentid" = "1"
"ptime" = "1493370776000"

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

"cataname" = "新建分类测试"
"catatype" = "0"
"cataurl" = "分类链接"
"parentid" = "1"
"ptime" = "1493370776000"

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

cataname=新建分类测试&catatype=0&cataurl=分类链接&parentid=1&ptime=14933707760003OmoLbTlHu

4、生成签名sign

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

删除分类

接口URL

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

接口说明

删除分类

支持格式

JSON

HTTP请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名 必选 类型 说明
cataid string 该分类id
ptime string 当前时间的毫秒级时间戳(13位),3分钟内有效
sign string 签名,为40位大写SHA1值
userid string POLYV用户ID,http://api.polyv.net/v2/video/{userid}/updateCata中的{userid}需要替换为POLYV用户ID的值

返回结果

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

字段说明

参数 类型 说明
code int 成功/失败代码
status string 成功/失败状态
message string 成功/失败信息
data boolean 成功响应的数据

php请求示例

<?php
  $userid="9f1e0689e1";
  $cataid="1469603317481";
  $ptime=time()*1000;
  $secretkey="AkDipaULWw";
  $str="cataid=$cataid&ptime=$ptime&userid=$userid".$secretkey;
  $sign=strtoupper(sha1($str));
  $url="http://api.polyv.net/v2/video/$userid/deleteCata?cataid=$cataid&ptime=$ptime&sign=$sign";
  $content = file_get_contents($url);
  echo $content;
?>

签名规则

将请求参数(sign除外)按照参数名字典顺序排列,用“&”连接参数名与参数值,并在最后加上secretkey的值,生成40位大写SHA1值,作为sign。

以下是示例过程:

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

userid="9f1e0689e1";
cataid="1469603317481";
ptime="1469603573000";

2. 连接字符串
用“&”连接参数名与参数值,并在最后加上secretkey的值,生成40位大写SHA1值,作为sign(本示例的值为AkDipaULWw),如下:

cataid=1469603317481&ptime=1469603573000&userid=9f1e0689e1AkDipaULWw

3. 生成签名sign

sign为40位大写SHA1值:

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

修改分类名称

接口URL

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

接口说明

修改视频分类的名称

支持格式

JSON

请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名 必选 类型 说明
cataname string 修改后的分类名称
cataid string 该分类id
ptime string 当前时间的毫秒级时间戳(13位),3分钟内有效
sign string 签名,为40位大写的SHA值
userid string POLYV用户ID,http://api.polyv.net/v2/video/{userid}/updateCata中的{userid}需要替换为POLYV用户ID的值

返回结果

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

字段说明

参数 类型 说明
code int 成功/失败代码
status string 成功/失败状态
message string 成功/失败信息
data boolean 成功响应的数据

php请求示例

<?php
  $userid="3828390191";
  $cataname="polyv";
  $cataid="1466567123649";
  $ptime=time()*1000;
  $secretkey="tIQp4ATe9Z";
  $str="cataid=$cataid&cataname=$cataname&ptime=$ptime&userid=$userid".$secretkey;
  $sign=strtoupper(sha1($str));
  $url="http://api.polyv.net/v2/video/$userid/updateCata?cataid=$cataid&cataname=$cataname&ptime=$ptime&sign=$sign";
  $content = file_get_contents($url);
  echo $content;
?>

签名规则

将请求参数(sign除外)按照参数名字典顺序排列,用“&”连接参数名与参数值,并在最后加上secretkey的值,生成40位大写的SHA1值,作为sign。

以下是示例过程:

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

userid="3828390191";
cataname="polyv";
cataid="1466567123649";
ptime="1469599842000";

2. 连接字符串
用“&”连接参数名与参数值,并在最后加上secretkey的值,生成40位大写的SHA1值,作为sign(本示例的值为tIQp4ATe9Z),如下:

cataid=1466567123649&cataname=polyv&ptime=1469599842000&userid=3828390191tIQp4ATe9Z

3. 生成签名sign

sign为40位大写的SHA1值:

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

移动视频到指定分类

接口URL

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

接口说明

将某些视频移动到某个分类下

支持格式

JSON

请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名 必选 类型 说明
userid string POLYV用户ID,http://api.polyv.net/v2/video/{userid}/changeCata中的{userid}需要替换为POLYV用户ID的值
vids string 视频的ID,可以选择多个视频,如“e2e84a7383e275772f277359d70d7038_e,e2e84a73830123ca5a368ec61bde2d8b_e,...”
cataid string 视频将要移动到的目标分类ID
ptime string 当前时间的毫秒级时间戳(13位),3分钟内有效
sign string 签名,为40位大写的SHA1值

注意事项

    vids参数如果有多个的话请用英文输入法的逗号“,”分割开

响应参数

参数名 类型 说明
code int 成功/失败代码
status string 成功/失败状态
message string 成功/失败信息
data string 成功响应的数据

JSON示例

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

code值说明

code值 说明
200 视频成功移动到目标分类
400 视频移动到目标分类失败,具体信息可以参照message

php请求示例

<?php
  $userid="e2e84a7383";
  $vids="e2e84a7383e275772f277359d70d7038_e,e2e84a73830123ca5a368ec61bde2d8b_e,e2e84a73831dcd96b512ea236a35d1b9_e";
  $cataid="1462440513084";
  $ptime=time()*1000;
  $secretkey="7UagtQOq2A";
  $str="cataid=$cataid&ptime=$ptime&userid=$userid&vids=$vids".$secretkey;
  $sign=strtoupper(sha1($str));
  $url="http://api.polyv.net/v2/video/$userid/changeCata?cataid=$cataid&ptime=$ptime&vids=$vids&sign=$sign";
  $content = file_get_contents($url);
  echo $content;
?>

签名规则

将请求参数(sign除外)按照参数名字典顺序排列,用“&”连接参数名与参数值,并在最后加上secretkey的值,生成40位大写的SHA1值,作为sign。

以下是示例过程:

1. 请求参数为:

userid="e2e84a7383"
vids="e2e84a7383e275772f277359d70d7038_e,e2e84a73830123ca5a368ec61bde2d8b_e,e2e84a73831dcd96b512ea236a35d1b9_e"
ptime="1512984445000"
cataid="1462440513084"
secretkey="7UagtQOq2A"

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

cataid="1462440513084"
ptime="1512984445000"
userid="e2e84a7383"
vids="e2e84a7383e275772f277359d70d7038_e,e2e84a73830123ca5a368ec61bde2d8b_e,e2e84a73831dcd96b512ea236a35d1b9_e"
secretkey="7UagtQOq2A"

3. 连接字符串

连接参数名与参数值,并在首尾加上secretkey的值(本示例的值为7UagtQOq2A),如下:

cataid=1462440513084&ptime=1512984445000&userid=e2e84a7383&vids=e2e84a7383e275772f277359d70d7038_e,e2e84a73830123ca5a368ec61bde2d8b_e,e2e84a73831dcd96b512ea236a35d1b9_e7UagtQOq2A

4. 生成签名sign

sign为40位大写的SHA1值:

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

获取视频分类的信息

接口URL

http://v.polyv.net/uc/services/rest?method=getCata

接口说明

作用:获取视频分类

支持格式

JSON

HTTP请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名 必选 类型 说明
cataid string 视频分类的id
readtoken string 用户的读取钥匙
sign string 签名,为40位大写的SHA1值
format string 默认只返回json格式,无需format

返回结果

{
"error": "0",
"data": [
{
"articles": "1",
"cataename": "",
"userid": "e2e84a7383",
"templateid": "0",
"parentid": "1",
"catatype": "0",
"cataname": "测试1",
"ext": "",
"hostid": "e",
"cataurl": "",
"extype": "\u0000\u0000\u0000",
"lmodify": "1410230776538",
"isdel": "0",
"catasort": "",
"ptime": "1410230776538",
"catatree": "1,1410230776538",
"cataid": "1410230776538"
},
{
"articles": "0",
"cataename": "",
"userid": "e2e84a7383",
"templateid": "0",
"parentid": "1410230776538",
"catatype": "0",
"cataname": "测试1-1",
"ext": "",
"hostid": "e",
"cataurl": "",
"extype": "\u0000\u0000\u0000",
"lmodify": "1410431619199",
"isdel": "0",
"catasort": "",
"ptime": "1410431619199",
"catatree": "1,1410230776538,1410431619199",
"cataid": "1410431619199"
},
{
"articles": "0",
"cataename": "",
"userid": "e2e84a7383",
"templateid": "0",
"parentid": "1410230776538",
"catatype": "0",
"cataname": "测试1-2",
"ext": "",
"hostid": "e",
"cataurl": "",
"extype": "\u0000\u0000\u0000",
"lmodify": "1410431629027",
"isdel": "0",
"catasort": "",
"ptime": "1410431629027",
"catatree": "1,1410230776538,1410431629027",
"cataid": "1410431629027"
},
{
"articles": "1",
"cataename": "",
"userid": "e2e84a7383",
"templateid": "0",
"parentid": "1",
"catatype": "0",
"cataname": "测试2",
"ext": "",
"hostid": "e",
"cataurl": "",
"extype": "\u0000\u0000\u0000",
"lmodify": "1410230787507",
"isdel": "0",
"catasort": "",
"ptime": "1410230787507",
"catatree": "1,1410230787507",
"cataid": "1410230787507"
}
]
}

字段 说明
error 错误提示
articles 视频数目
userid 用户id
templateid 模板id
parentid 父分类id
catatype 分类类型
cataname 分类名称
hostid 主机id
extype 以前的类型
isdel 已经删除
catasort 分类排序
ptime 上传时间
catatree 视频所在分类
cataid 分类id, 如1为根目录

php请求示例

<?php
  $readtoken = "c89b576f-2abd-485f-81f9-245d5ba7807f";
  $cataid = "1499329701906";
  $format ="";
  $secretkey ="E8qVf7rCFo";
  $str = "cataid=".$cataid."&readtoken=".$readtoken.$secretkey;
  $sign = strtoupper(sha1($str));
  $url = "http://v.polyv.net/uc/services/rest?method=getCata&cataid=".$cataid."&readtoken=".$readtoken."&format=".$format."&sign=".$sign;
  $content = file_get_contents($url);
  echo $content;
?>

 

签名规则

将请求参数(sign除外)按照参数名字典顺序排列,用“&”连接参数名与参数值,并在最后加上secretkey的值,生成40位大写SHA1值,作为sign。

以下是示例过程:

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

cataid="1499329701906";
readtoken="c89b576f-2abd-485f-81f9-245d5ba7807f"

2. 连接字符串
用“&”连接参数名与参数值,并在最后加上secretkey的值,生成40位大写SHA1值,作为sign(本示例的值为E8qVf7rCFo),如下:

cataid=1499329701906&readtoken=c89b576f-2abd-485f-81f9-245d5ba7807fE8qVf7rCFo

3. 生成签名sign

sign为40位大写SHA1值:

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

获取视频分类目录

接口URL

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

接口说明

作用:获取视频分类目录

支持格式

JSON

HTTP请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名 必选 类型 说明
ptime string 当前时间的毫秒级时间戳(13位),3分钟内有效
userid string POLYV用户ID, http://api.polyv.net/v2/user/{userid}/main中的{userid}需要替换为POLYV用户ID的值
cataid int 分类id,默认为根目录,获取该分类下的树结构json
sign string 签名,为40位大写的SHA1值

返回结果

{
    "code": 200, 
    "status": "success", 
    "message": "success", 
    "data": [
        {
            "text": "默认分类 (39) ", 
            "cataname": "默认分类", 
            "catatree": "1", 
            "cataid": 1, 
            "parentid": 0, 
            "videos": 39, 
            "nodes": [
                {
                    "text": "第一个分类 (5) ", 
                    "cataname": "第一个分类", 
                    "catatree": "1,1466071267861", 
                    "cataid": 1466071267861, 
                    "parentid": 1, 
                    "videos": 5, 
                    "nodes": [
                        {
                            "text": "1.1 (3) ", 
                            "cataname": "1.1", 
                            "catatree": "1,1466071267861,1474873773161", 
                            "cataid": 1474873773161, 
                            "parentid": 1466071267861, 
                            "videos": 3
                        }, 
                        {
                            "text": "1.2 (2) ", 
                            "cataname": "1.2", 
                            "catatree": "1,1466071267861,1474873783646", 
                            "cataid": 1474873783646, 
                            "parentid": 1466071267861, 
                            "videos": 2
                        }
                    ]
                }, 
                {
                    "text": "第二个分类 (2) ", 
                    "cataname": "第二个分类", 
                    "catatree": "1,1474873733364", 
                    "cataid": 1474873733364, 
                    "parentid": 1, 
                    "videos": 2
                }, 
                {
                    "text": "第三个分类 (9) ", 
                    "cataname": "第三个分类", 
                    "catatree": "1,1474873744871", 
                    "cataid": 1474873744871, 
                    "parentid": 1, 
                    "videos": 9, 
                    "nodes": [
                        {
                            "text": "3.1 (2) ", 
                            "cataname": "3.1", 
                            "catatree": "1,1474873744871,1474873792718", 
                            "cataid": 1474873792718, 
                            "parentid": 1474873744871, 
                            "videos": 2
                        }, 
                        {
                            "text": "3.2 (6) ", 
                            "cataname": "3.2", 
                            "catatree": "1,1474873744871,1474873800254", 
                            "cataid": 1474873800254, 
                            "parentid": 1474873744871, 
                            "videos": 6
                        }
                    ]
                }, 
                {
                    "text": "第四个分类 (4) ", 
                    "cataname": "第四个分类", 
                    "catatree": "1,1474873756622", 
                    "cataid": 1474873756622, 
                    "parentid": 1, 
                    "videos": 4
                }
            ]
        }
    ]
}

字段 说明
code 成功/失败代码
status 成功/失败代码
message 成功/失败信息
text 分类名和该分类下视频总数的组合
cataname 分类名
cataree 分类树,显示从根目录到该目录每一层的分类id
cataid 分类id,如果为1则是根目录
parentid 上一级分类id,根目录的上一级分类为0
videos 此分类及其子分类视频总数
nodes 该分类的子分类

php请求示例

<?php
  $userid = "4802b9bb81";
  $ptime = time()*1000;
  $secretkey = "fRJiHrsZzw";
  $str = "ptime=$ptime"."&userid=$userid".$secretkey;
  $sign = strtoupper(sha1($str));
  $url = "http://api.polyv.net/v2/video/$userid/cataJson?ptime=".$ptime."&sign=".$sign;
  $content = file_get_contents($url);
  echo $content;
?>

示例Demo

下面“获取视频分类Demo.zip”提供了两种方法解析jsontree得到目录的demo
一种是使用bootstrap插件treeview
另一种是使用jquery插件treeview(这个方法中通过解析json然后拼凑页面的元素的方法,可以应用于不同插件,方便外部开发者参考调用)

获取视频分类Demo.zip

 

签名规则

将请求参数(sign除外)按照参数名字典顺序排列,用“&”连接参数名与参数值,并在最后加上secretkey的值,生成40位大写SHA1值,作为sign。

以下是示例过程:

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

ptime="1470969330000";
userid="4802b9bb81";

2. 连接字符串
用“&”连接参数名与参数值,并在最后加上secretkey的值,生成40位大写SHA1值,作为sign(本示例的值为fRJiHrsZzw),如下:

ptime=1474882994000&userid=4802b9bb81fRJiHrsZzw

3. 生成签名sign

sign为40位大写SHA1值:

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