批量建立頻道

舊版介面位址批量建立頻道(舊版)

舊版介面升級新版注意事項

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
}