获取单个播放列表

点击这里查看旧版

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