Query Live Series Session List

API Description

1、查询系列直播场次列表
2、接口支持https协议

API URL

http://api.polyv.net/live/v4/channel/session/new/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 Parameters

Example

http://api.polyv.net/live/v4/channel/session/new/list?appId=frlr1zazn3&timestamp=1632809855078&channelId=2588188&sign=D02FA683640135D843D485EE84F6632A

Response Parameters

data Field Description

contents Field Description

diskVideoVO Field Description

interactionScriptVO Field Description

Java Request Example

For quick integration of basic code, please download the relevant dependency source code. Click here to download source code. After downloading, add it to your own source code project. The test cases include HttpUtil.java and LiveSignUtil.java, both contained in the download file.

It is strongly recommended to use the Live Java SDK for API integration. The Live 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(ChannelOperateTest.class);
/**
 * 获取新场次列表
 * @throws IOException
 * @throws NoSuchAlgorithmException
 */
@Test
public void listTest() throws IOException, NoSuchAlgorithmException {
    //公共参数,填写自己的实际参数
    String appId = super.appId;
    String appSecret = super.appSecret;
    //API请求地址
    String url = "http://api.polyv.net/live/v4/channel/session/new/list";
    String timestamp = String.valueOf(System.currentTimeMillis());
    //请求参数
    Map<String, String> params = new HashMap<String, String>();
    params.put("appId", appId);
    params.put("timestamp", timestamp);
    params.put("channelId", "2588188");
    //生成签名
    String sign = LiveSignUtil.getSign(params, appSecret);
    params.put("sign", sign);
    //发送请求
    String result = HttpUtil.sendGet(url, params);
    //打印结果
    log.info("返回值：{}", response);
}

Response Example

For system-wide global error descriptions, see Global Error Description

Success Example

{
    "code": 200,
    "status": "success",
    "message": "",
    "data": {
        "pageNumber": 1,
        "pageSize": 10,
        "totalPages": 1,
        "totalItems": 2,
        "contents": [
            {
                "channelId": 2588188,
                "sessionId": "e9s2h3jd8f",
                "name": "测试场次1",
                "endTime": 1761201953000,
                "status": "end",
                "createdTime": 1761201953000,
                "planStartTime": 1761201953000,
                "planEndTime": 1761201953000,
                "streamType": "client",
                "pushClient": "web",
                "splashImg": "https://example.com/image1.jpg",
                "splashLargeImg": "https://example.com/large-image1.jpg",
                "splashImgBackgroundId": 1,
                "watchUrl": "https://live.polyv.net/2588188/e9s2h3jd8f",
                "userId": "user123"
            },
            {
                "channelId": 2588188,
                "sessionId": "k7d9f2h1l5",
                "name": "测试场次2",
                "endTime": 1761201953000,
                "status": "end",
                "createdTime": 1761201953000,
                "planStartTime": 1761201953000,
                "planEndTime": 1761201953000,
                "streamType": "client",
                "pushClient": "web",
                "splashImg": "https://example.com/image2.jpg",
                "splashLargeImg": "https://example.com/large-image2.jpg",
                "splashImgBackgroundId": 2,
                "watchUrl": "https://live.polyv.net/2588188/k7d9f2h1l5",
                "userId": "user123"
            }
        ]
    }
}

Error Example

{
    "code": 400,
    "status": "error",
    "message": "invalid signature.",
    "data": ""
}