获取单个播放列表

点击这里查看旧版

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

获取播放列表信息

getPlayList

    作用:获取用户播放视频列表信息

URL

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

支持格式

    XML/JSON

HTTP请求方式

    POST,GET

请求数限制

    TRUE

请求参数

参数名必选类型及范围说明
readtokentruestring用户的读取钥匙
pageNumtrueint取第几页
numPerPagefalseint平均每页取多少条数据
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>
<video>
<title>播放列表4</title>
<tag>列表4</tag>
<lmodify>2014-09-25 19:08:56</lmodify>
<describ>这是播放列表4</describ>
<ptime>2014-09-25 19:08:56</ptime>
<videoid>1411643336975</videoid>
<video_count>3</video_count>
</video>
<video>
<title>播放列表3</title>
<tag>列表3</tag>
<lmodify>2014-09-25 19:08:12</lmodify>
<describ>这是播放列表3</describ>
<ptime>2014-09-25 19:08:12</ptime>
<videoid>1411643292560</videoid>
<video_count>3</video_count>
</video>
<video>
<title>播放列表1</title>
<tag>列表1</tag>
<lmodify>2014-09-25 18:47:52</lmodify>
<describ>这是播放列表1</describ>
<ptime>2014-09-09 10:35:17</ptime>
<videoid>1410230117053</videoid>
<video_count>6</video_count>
</video>
</data>
</xml>

JSON示例

{"error":"0","data":
[
{"title":"播放列表4",
"tag":"列表4",
"lmodify":"2014-09-25 19:08:56",
"describ":"这是播放列表4",
"ptime":"2014-09-25 19:08:56",
"videoid":"1411643336975",
"video_count":"3"},
{"title":"播放列表3",
"tag":"列表3",
"lmodify":"2014-09-25 19:08:12",
"describ":"这是播放列表3",
"ptime":"2014-09-25 19:08:12",
"videoid":"1411643292560",
"video_count":"3"},
{"title":"播放列表1",
"tag":"列表1",
"lmodify":"2014-09-25 18:47:52",
"describ":"这是播放列表1",
"ptime":"2014-09-09 10:35:17",
"videoid":"1410230117053",
"video_count":"6"}
]
}

字段说明

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