批量创建频道

旧版接口地址批量创建频道(旧版)

旧版接口升级新版注意事项

1、旧版接口创建频道时，能直接设置频道基本信息、观看条件、回放设置、讲师设置、角色设置；
2、新版接口创建频道时，只能设置频道基本信息，观看条件、回放设置、讲师设置、角色设置来源于默认模板设置，在创建频道前需设置好默认模板；
3、默认模板的修改不会对已创建的频道产生影响，已创建频道信息的修改与旧版接口一致；

接口描述

1、批量创建频道
2、（timestamp, appId）参与sign签名，并和sign一起通过url传递，请求体参数不参与签名，通过post请求体传递【请设置请求头contentType:application/json】
3、接口支持https协议

接口URL

http://api.polyv.net/live/v4/channel/create-batch

在线API调用

请求方式

POST

接口约束

1、接口同时支持HTTP 、HTTPS ，建议使用HTTPS 确保接口安全，接口调用有频率限制，详细请查看

2、直播场景为双师课、研讨会时，不支持转播类型设置；直播延迟为无延迟时，不支持转播类型设置；

3、直播场景为研讨会时，不支持直播延迟、转播、连麦人数设置；

4、研讨会场景下主持人密码和参会人密码不能相同；

5、单次最多创建30个频道；

请求参数描述

请求体参数描述

示例

http://api.polyv.net/live/v4/channel/create-batch?appId=frlr1zazn3&sign=FD701BFA3DCE2C7DCC362A904DBF48B0&timestamp=1636536555144

请求体json参数：

[
    {
        "name": "研讨会",
        "newScene": "seminar",
        "pureRtcEnabled": "Y",
        "categoryId": 391352,
        "seminarHostPassword": "",
        "seminarAttendeePassword": ""
    },
    {
        "name": "我的频道-子账号",
        "newScene": "topclass",
        "template": "ppt",
        "pureRtcEnabled": "Y",
        "subAccount": "sdk-demo@polyv.net",
        "channelPasswd": "",
        "categoryId": 391352
    }
]

响应参数描述

data参数描述

element参数描述

Java请求示例

快速接入基础代码请下载相关依赖源码， 点击下载源代码 ,下载后加入到自己的源码工程中即可。测试用例中的HttpUtil.java 和 LiveSignUtil.java 都包含在下载文件中。

强烈建议您使用直播Java SDK完成API的功能对接，直播Java SDK 对API调用逻辑、异常处理、数据签名、HTTP请求线程池进行了统一封装和优化。

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

    @Test
    public void testCreateBatchV4() throws IOException, NoSuchAlgorithmException {
        //公共参数,填写自己的实际
        String appId = super.appId;
        String appSecret = super.appSecret;
        String userId = super.userId;
        String timestamp = String.valueOf(System.currentTimeMillis());
        //业务参数
        String url = "http://api.polyv.net/live/v4/channel/create-batch";
        
        //http 调用逻辑
        Map<String, String> requestMap = new HashMap<>();
        requestMap.put("appId", appId);
        requestMap.put("timestamp", timestamp);
        
        requestMap.put("sign", LiveSignUtil.getSign(requestMap, appSecret));
        
        String body = "[{\"name\":\"研讨会\",\"newScene\":\"seminar\",\"pureRtcEnabled\":\"Y\",\"categoryId\":391352," +
        "\"seminarHostPassword\":\"aaaaaa\",\"seminarAttendeePassword\":\"bbbbbb\"},{\"name\":\"我的频道-子账号\"," +
        "\"newScene\":\"topclass\",\"template\":\"ppt\",\"pureRtcEnabled\":\"Y\",\"subAccount\":\"sdk-demo@polyv" +
        ".net\",\"channelPasswd\":\"123fds\",\"categoryId\":391352}]";
        url = HttpUtil.appendUrl(url, requestMap);
        String response = HttpUtil.postJsonBody(url,body,null);
        
        log.info("测试批量创建频道，返回值：{}", response);
        //do somethings
        
    }

响应示例

系统全局错误说明详见全局错误说明

成功示例

{
    "code": 200,
    "status": "success",
    "requestId": "62af5d29-a836-4bfb-8c4d-cbd6a84ea7e9",
    "data": [
        {
            "channelId": 2665205,
            "userId": "1b448be323",
            "scene": null,
            "channelPasswd": null,
            "seminarHostPassword": "aaaaaa",
            "seminarAttendeePassword": "bbbbbb"
        },
        {
            "channelId": 2665206,
            "userId": "1b448be323",
            "scene": null,
            "channelPasswd": "123fds",
            "seminarHostPassword": null,
            "seminarAttendeePassword": null
        }
    ],
    "success": true
}

异常示例

{
    "code": 400,
    "status": "error",
    "requestId": "4081dbac03e6441e8bdd301d8feee5a2.124.16360831818611581",
    "error": {
        "code": 20001,
        "desc": "application not found."
    },
    "success": false
}