批量修改视频的授权方式

接口URL

http://api.polyv.net/v2/config/{userid}/hlslevel

接口说明

通过vids批量修改视频的授权方式。

支持格式

JSON

请求方式

POST

请求数限制

TRUE

请求参数

参数名 必选 类型 说明
userid string 用户ID
hlslevel string 加密授权参数,值为open/web/app之一,open为开放授权,web为WEB授权,app为APP授权
ptime string 13位当前时间毫秒级时间戳
vids string 多个视频的vid,用英文逗号隔开
sign string 签名,40位大写的sha1值

响应成功JSON****示例:

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

响应失败JSON****示例:

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

字段说明

参数名 说明
code 返回状态码
status 返回状态值
message 返回信息
data 返回数据

php请求示例

<?php
header("Content-type: text/html; charset=utf-8");
$userid="7d26575efe";
$hlslevel= "web";  //值为open/web/app之一
$vids = "7d26575efe9eef80bafa426ff6dd7dc4_7,7d26575efebc3f04e1632fee60d34972_7";
$ptime= time()*1000;
$secretkey = "ABIEn1UJht";

$str = "hlslevel=$hlslevel&ptime=$ptime&vids=$vids".$secretkey;
$sign = strtoupper(sha1($str));

$url="http://api.polyv.net/v2/config/{$userid}/hlslevel";
$post_data = array (
"hlslevel" => $hlslevel,
"ptime" => $ptime,
"vids" => $vids,
"sign" => $sign,
);
$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、将请求参数按照参数名字典顺序排列为

hlslevel = "web"
ptime = "1500950616000"
vids = "7d26575efe9eef80bafa426ff6dd7dc4_7,7d26575efebc3f04e1632fee60d34972_7"

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

hlslevel=web&ptime=1500950616000&vids=7d26575efe9eef80bafa426ff6dd7dc4_7,7d26575efebc3f04e1632fee60d34972_7ABIEn1UJht

3、sign为40位大写的SHA1值

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

获取单个播放列表

点击这里查看旧版

接口URL

http://api.polyv.net/v2/play/{userid}/play-list/{id}

接口说明

获取单个播放列表

支持格式

XML/JSON

请求方式

GET

请求数限制

TRUE

请求参数

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

注意事项

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

PHP示例代码

<?php
$userid="9f1e0689e1";
$id="1474448170995";
$format="";
$jsonp="";
$ptime=time()*1000;
$secretkey="AkDipaULWw";
$str="";
$url="http://api.polyv.net/v2/play/{$userid}/play-list/{$id}?";
if (empty($format)) {
    $str.="id=".$id;
}else{
    $str.="format=".$format."&id=".$id;
    $url.="format=$format&";
}
if (empty($jsonp)) {
    $str.="&ptime=".$ptime.$secretkey;
}else{
    $str.="&jsonp=".$jsonp."&ptime=".$ptime.$secretkey;
    $url.="jsonp=$jsonp&";
}
$hash=strtoupper(sha1($str));
$url.="ptime=$ptime&sign=$hash";
$content=file_get_contents($url);//只能get
echo $content;
?>

返回结果XML示例

<xml>
    <code>200</code>
    <status>success</status>
    <message>success</message>
    <data>
        <describ></describ>
        <tag></tag>
        <title>播放列表1</title>
        <lmodify>2017-04-18 10:01:33</lmodify>
        <video_count>4</video_count>
        <videoid>1474448170995</videoid>
        <ptime>2016-09-21 16:56:10</ptime>
        <videolist>
            <vid>9f1e0689e1a156fc6b373eab9195b0c6</vid>
            <title>刘诗昆钢琴教程4</title>
            <duration>00:35:52</duration>
            <publish_url />
            <first_image>http://img.videocc.net/uimage/9/9f1e0689e1/6/9f1e0689e1a156fc6b373eab9195b0c6_0.jpg</first_image>
            <default_videolink></default_videolink>
        </videolist>
        <videolist>
            <vid>9f1e0689e1c98f0cf1554c0d677f0846</vid>
            <title>刘诗昆钢琴教程3</title>
            <duration>00:32:50</duration>
            <publish_url />
            <first_image>http://img.videocc.net/uimage/9/9f1e0689e1/6/9f1e0689e1c98f0cf1554c0d677f0846_0.jpg</first_image>
            <default_videolink></default_videolink>
        </videolist>
        <videolist>
            <vid>9f1e0689e10aa6973b4bd7031f6b1fac</vid>
            <title>刘诗昆钢琴教程2</title>
            <duration>00:25:15</duration>
            <publish_url />
            <first_image>http://img.videocc.net/uimage/9/9f1e0689e1/c/9f1e0689e10aa6973b4bd7031f6b1fac_0.jpg</first_image>
            <default_videolink></default_videolink>
        </videolist>
        <videolist>
            <vid>9f1e0689e124de49e580c7ec434508f7</vid>
            <title>刘诗昆钢琴教程1</title>
            <duration>00:35:51</duration>
            <publish_url />
            <first_image>http://img.videocc.net/uimage/9/9f1e0689e1/7/9f1e0689e124de49e580c7ec434508f7_0.jpg</first_image>
            <default_videolink></default_videolink>
        </videolist>
    </data>
</xml>

返回结果JSON示例

{
    "code": 200,
    "status": "success",
    "message": "success",
    "data": [{
        "describ": "",
        "tag": "",
        "title": "播放列表1",
        "lmodify": "2017-04-18 10:01:33",
        "video_count": "4",
        "videoid": "1474448170995",
        "ptime": "2016-09-21 16:56:10",
        "videolist": [{
            "vid": "9f1e0689e1a156fc6b373eab9195b0c6",
            "title": "刘诗昆钢琴教程4",
            "duration": "00:35:52",
            "publish_url": null,
            "first_image": "http://img.videocc.net/uimage/9/9f1e0689e1/6/9f1e0689e1a156fc6b373eab9195b0c6_0.jpg",
            "default_videolink": ""
        }, {
            "vid": "9f1e0689e1c98f0cf1554c0d677f0846",
            "title": "刘诗昆钢琴教程3",
            "duration": "00:32:50",
            "publish_url": null,
            "first_image": "http://img.videocc.net/uimage/9/9f1e0689e1/6/9f1e0689e1c98f0cf1554c0d677f0846_0.jpg",
            "default_videolink": ""
        }, {
            "vid": "9f1e0689e10aa6973b4bd7031f6b1fac",
            "title": "刘诗昆钢琴教程2",
            "duration": "00:25:15",
            "publish_url": null,
            "first_image": "http://img.videocc.net/uimage/9/9f1e0689e1/c/9f1e0689e10aa6973b4bd7031f6b1fac_0.jpg",
            "default_videolink": ""
        }, {
            "vid": "9f1e0689e124de49e580c7ec434508f7",
            "title": "刘诗昆钢琴教程1",
            "duration": "00:35:51",
            "publish_url": null,
            "first_image": "http://img.videocc.net/uimage/9/9f1e0689e1/7/9f1e0689e124de49e580c7ec434508f7_0.jpg",
            "default_videolink": ""
        }]
    }]
}

字段说明

字段 说明
code 返回码
status 返回状态
message 返回信息
describ 详细介绍
tag 标签
title 播放列表标题
lmodify 最后修改时间
video_count 视频数量
videoid 视频列表ID
ptime 创建时间
videolist 视频集合
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

新建播放列表

createPlayList

    作用:创建播放列表

URL

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

支持格式

    XML/JSON

HTTP请求方式

    POST,GET

请求数限制

    TRUE

请求参数

参数名必选是否必须类型说明
writetokentruestring用户的写密钥
tagfalsestring视频标签
titletruestring标题
descfalsestring 描述

返回结果

<xml>
<error>0</error>
<total/>
</xml>

JSON示例

{
id: 1456889162568,
error: "0"
}

字段说明

字段说明
id播放列表的id
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

修改播放列表

modifyPlayList

    作用:修改播放列表

URL

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

支持格式

    XML/JSON

HTTP请求方式

    POST,GET

请求数限制

    TRUE

请求参数

参数名必选是否必须类型说明
idtruelong播放列表id
writetokentruestring用户的写密钥
tagfalsestring视频标签
titletruestring标题
descfalsestring 描述
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

移动视频到播放列表

addToPlayList

    作用:创建播放列表

URL

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

支持格式

    XML/JSON

HTTP请求方式

    POST,GET

请求数限制

    TRUE

请求参数

参数名必选类型说明
idtruelong播放列表的id,在“视频管理”——“播放列表”中可以获取,如下图所示
writetokentruestring用户的写密钥
vidtruelong视频id
1

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

将视频从播放列表移除

removeFromPlayList

    作用:将视频从播放列表移除

URL

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

支持格式

    XML/JSON

HTTP请求方式

    POST,GET

请求数限制

    TRUE

请求参数

参数名必选类型说明
idtruelong播放列表的id,在“视频管理”——“播放列表”中可以获取,如下图所示
writetokentruestring用户的写密钥
vidtruelong视频id
1

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

视频播放设置

editFlashPlay

    作用:视频播放设置

URL

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

支持格式

    XML/JSON

HTTP请求方式

    POST,GET

请求数限制

    TRUE

请求参数

参数名必选类型及范围说明
writetokentruestring用户的上传钥匙
vidtruestring视频ID
my_brfalseint码率1.普通,2.清晰3.高清
widthfalseintflash宽度
heightfalseintflash高度
videoautofalseintflash自动播放,1自动播放,0取消自动播放
formatfalsestring默认返回json格式,如果format=xml返回xml格式
jsonpfalsestring 例如,正常情况{error:0,data:””},加 jsonp=a后返回a({error:0,data:””})

返回错误提示

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

返回结果

    <xml>
    <error>0</error>
    <data>
    <videoplay><height>"300"</height><definition>"1"</definition>    <width>"400"</width><videoauto>"1"</videoauto></videoplay>
    </data>
    </xml>

JSON示例

{"error":"0","data:{"height":"300","definition":"1","width":"400","videoauto":"1"}}

字段说明

字段说明
error错误提示
heightflash高度
definition视频码率
width视频宽度
videoauto是否自动播放

注意事项

该接口对应的是POLYV管理系统中视频设置里面的播放设置板块,需要注意的是,此项设置只对新上传视频有效。

QQ截图20160920182053

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

设置视频的播放器id

changePlayer

    作用:设置视频的播放器id

URL

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

支持格式

    JSON

HTTP请求方式

    POST,GET

请求数限制

    TRUE

请求参数

参数名必选类型及范围说明
writetokentruestring用户的写钥匙
vidtruestring视频的id
playeridtruestring播放器的id,在POLYV后台——播放器设置界面上可以找到;当playerid的值为其他非法值时,视频的播放器id则会设置为默认播放器的id
jsonpfalsestring 例如,正常情况{error:0,data:""},加jsonp=a后返回a({error:0,data:""})

注意事项

    返回错误列表

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

JSON示例

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

设置播放域名黑白名单

saveHostUrl

    作用:设置播放域名黑白名单

URL

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

支持格式

    JSON

HTTP请求方式

    POST,GET

请求数限制

    TRUE

请求参数

参数名必选类型及范围说明
writetokentruestring用户的写钥匙
hosttruestringhost字符串,用逗号隔开,如果文本条数过大建议用post方法提交
settingTypetruestring设置类型:
1:黑名单
2:白名单
jsonpfalsestring 例如,正常情况{error:0,data:""},加jsonp=a后返回a({error:0,data:""})

注意事项

    返回错误列表

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

JSON示例

{
error: "0"
}

字段说明

字段说明
error错误提示

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

设置域名限制规则

saveHostSetting_type

    作用:设置域名限制规则

URL

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

支持格式

    JSON

HTTP请求方式

    POST,GET

请求数限制

    TRUE

请求参数

参数名必选类型及范围说明
writetokentruestring用户的写钥匙
settingTypetruestring设置类型: 0:无域名限制
1:播放器启动禁止域名黑名单
2:播放器启动允许域名白名单
3:启动允许以及禁止播放域 (注:先判断允许播放域,再判断禁止播放域)
jsonpfalsestring 例如,正常情况{error:0,data:""},加jsonp=a后返回a({error:0,data:""})

注意事项

    返回错误列表

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

JSON示例

{
error: "0",
settingType: 3
}

字段说明

字段说明
setting_type域名设置类型
0:无域名限制
1:播放器启动禁止域名黑名单
2:播放器启动允许域名白名单
3:启动允许以及禁止播放域 (注:先判断允许播放域,再判断禁止播放域)

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