保利威文档中心

帮助中心

创建播放列表

更新时间:2022-05-23 19:02:59

接口URL

https://api.polyv.net/v2/play-list/create

接口说明

创建播放列表

支持格式

JSON

请求方式

POST

请求参数

参数名 必选 类型及范围 说明
userid 是 string 用户ID
ptime 是 long 当前时间的毫秒级时间戳(13位),3分钟内有效
sign 是 String 签名,为40位大写的SHA1值【详见签名生成规则】
title 是 string 标题
description 否 string 描述
tag 否 string 标签

返回正确结果JSON示例

{
    "code": 200,
    "status": "success",
    "message": "success",
    "data": {
        "playListId": 1620220689111
    }
}

返回错误结果JSON示例

签名不正确
{
    "code":400,
    "status":"error",
    "message":"the sign is not right",
    "data":""
}
时间戳过期
{
    "code":400,
    "status":"error",
    "message":"ptime is too old.",
    "data":""
}

字段说明

字段 类型 说明
code int 返回码
status string 返回状态
message string 返回信息
data object 操作结果
playListId string 播放列表ID

java请求示例:

    public void testCreatePlayList() throws Exception {
        String url = "https://api.polyv.net/v2/play-list/create";
        Map<String, String> params = new HashMap<>();
        params.put("userid", userid);
        params.put("title", "标题");
        params.put("description", "描述");
        params.put("tag", "标签");
        params.put("ptime", String.valueOf(System.currentTimeMillis()));
        params.put("sign", getSign(params, secretkey));
        String response = HttpClientUtil.getInstance().sendHttpPost(url, params);
        System.out.println(response);
    }
联系客服,在线咨询
在线咨询