建立播放清單

更新時間：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);
    }