Query Series Live Session Information

API Description

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

API URL

http://api.polyv.net/live/v4/channel/session/new/get

Online API Call

Request Method

GET

API Constraints

1. The API supports both HTTP and HTTPS. It is recommended to use HTTPS to ensure API security. There is a frequency limit for API calls. For details, please see

Request Parameter Description

Example

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

Response Parameter Description

data Field Description

playbackConfig Field Description

diskVideoVO Field Description

interactionScriptVO Field Description

Java Request Example

For quick integration of the basic code, please download the relevant dependency source code, click to download the source code, and add it to your own source project after downloading. The HttpUtil.java and LiveSignUtil.java in the test cases are both included in the downloaded file.

It is strongly recommended that you use the Live Java SDK to complete API integration. The Live Java SDK uniformly encapsulates and optimizes API call logic, exception handling, data signing, and the HTTP request thread pool.

private static final Logger log = LoggerFactory.getLogger(ChannelOperateTest.class);
/**
 * 获取新场次信息
 * @throws IOException
 * @throws NoSuchAlgorithmException
 */
@Test
public void getTest() throws IOException, NoSuchAlgorithmException {
    //公共参数,填写自己的实际参数
    String appId = super.appId;
    String appSecret = super.appSecret;
    //API请求地址
    String url = "http://api.polyv.net/live/v4/channel/session/new/get";
    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");
    params.put("sessionId", "e9s2h3jd8f");
    //生成签名
    String sign = LiveSignUtil.getSign(params, appSecret);
    params.put("sign", sign);
    //发送请求
    String result = HttpUtil.sendGet(url, params);
    //打印结果
    log.info("返回值：{}", response);
}

Response Example

For the system global error description, see Global Error Description

Success example

{
    "code": 200,
    "status": "success",
    "message": "",
    "data": {
        "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,
        "playbackEnabled": "Y",
        "playbackConfig": {
            "playbackEnabled": "Y",
            "playbackOrigin": "vod",
            "videoId": "c81017120b"
        },
        "watchUrl": "https://live.polyv.net/2588188/e9s2h3jd8f",
        "userId": "user123"
    }
}

Exception example

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