点击这里查看旧版
接口URL
http://api.polyv.net/v2/play/{userid}/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_9</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_9</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_9</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_9</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_9",
"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_9",
"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_9",
"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_9",
"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 | 视频集合 |