Query Player List

API Description

查询账号下的全部播放器信息

API URL

http://api.polyv.net/v2/player/list

Online API Call

Request Method

GET

API Constraints

1. The API supports both HTTP and HTTPS. HTTPS is recommended for security. API calls have frequency limits. See details

Request Parameter Description

Example

http://api.polyv.net/v2/player/list?userid=abcde12345sign=F809B946258A112A78627A832B1F6A7D&ptime=1617845463779

Response Parameter Description

data Field Description

skin Field Description

logo Field Description

teaserTrailer Field Description

Java Request Example

For quick integration of basic code, download the relevant dependency source code. Click to download source code. After downloading, add it to your own source project. The HttpUtil.java and VodSignUtil.java in the test cases are included in the download file.

It is strongly recommended to use the VOD Java SDK for API integration. The VOD Java SDK provides unified encapsulation and optimization for API call logic, exception handling, data signing, and HTTP request thread pools.

private static final Logger log = LoggerFactory.getLogger(VodVideoPlayerTest.class);

/**
 * 查询播放器列表
 */
@Test
public void testPlayerList() throws Exception, NoSuchAlgorithmException {
        //公共参数,填写自己的实际参数
        String secretKey = "xxx";
        String userid = "xxx";
        String ptime = String.valueOf(System.currentTimeMillis());
        String url = "http://api.polyv.net/v2/player/list";

        Map<String, String> requestMap = new HashMap<>();
        requestMap.put("userid", userid);
        requestMap.put("ptime", ptime);
        requestMap.put("sign", VodSignUtil.getSign(requestMap, secretKey));
        String response = HttpUtil.get(url, requestMap);
        log.debug("测试查询播放器列表,{}", response);
        //do something
}

Response Example

For global error descriptions, see Global Error Description

Success Example

{
    "code": 200,
    "status": "success",
    "message": "success",
    "data": [
        {
            "playerId": "abcde12345",
            "playerName": "默认播放器",
            "isDefault": 1,
            "updateTime": "2025-02-18 14:51:36",
            "skin": {
                "skinTheme": "skin_red",
                "skinColor": "#d1d1d1",
                "skinColorApplyType": "panel",
                "skinControlLocation": 2
            },
            "logo": {
                "logoImageUrl": "https://img.videocc.net/xxx.jpg",
                "logoLinkUrl": "http://www.polyv.net",
                "logoOpacity": 100,
                "logoDisplayLocation": 1
            },
            "teaserTrailer": {
                "teaserShow": 0,
                "teaserMediaUrl": "",
                "teaserPlayTime": 0,
                "trailerShow": 0,
                "trailerMediaUrl": "",
                "trailerPlayTime": 0
            }
        }
    ]
}

Error Example

{
    "code": 400,
    "status": "error",
    "message": "the sign is not right.",
    "data": ""
}