创建云会议
创建云会议（支持会议室）
1. 接口描述
接口名称：
/confopenapi/room/reservConference
发送方式：
POST
参数格式：
accept: application/json;content-type: application/json
2. 输入参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| userId | 否 | int | 主持人用户ID（userId不传递时，必须传递email） |
| 否 | string | 主持人邮箱地址（支持不能提供userId但是通过该邮箱获得userId） | |
| title | 是 | string | 会议主题 |
| length | 是 | int | 会议时长,分钟为单位 |
| starttime | 是 | string | 会议开始时间（格式为2013-05-30 14:41:20） |
| liveOpenFlag | 否 | int | 是否开启直播,0: 不开启（默认值） 1: 开启；（账号必须有直播权限才可以预约出有直播的会议） |
| livePassword | 否 | string | 直播密码 |
| participantsLists | 否 | string | 参会人列表，包括两种：UMS UserId和外部Email，用分号分隔；例子 "participantsLists":"kai.zhang_5@quanshi.com;81422209", 如果传递邮箱， 视为外部参会人 |
| autoVideo | 否 | int | 入会是否自动开启视频 |
| joinLogin | 否 | int | 参会人入会必须登录 0:不需要登录(默认）1:需要登录 |
| useWaitingRoom | 否 | int | 是否开启等候室的开关，0：否，1：是 默认0 |
| summary | 否 | string | 备注 |
| confMode | 否 | int | 会议类型 0:视频会议(默认）1:数据会议 |
| openWatchword | 否 | int | 是否开启入会口令 ，0：否，1：是，默认0 |
| eventWatchword | 否 | string | 入会口令 |
| joinConfSelTag | 否 | int | 是否开启入会选择标签配置，0：否，1：是，默认0 |
| joinConfTags | 否 | string | 入会标签字符串，若joinConfSelTag=1，joinConfTagList不允许为空，标签之间用英文逗号区分,如“aa,bb” |
| isGnet | 否 | int | 是否使用云会议，0：不使用（现场会），1：使用（默认1） |
| hide | 否 | int | 会议室设备上是否隐藏会议主题 0：显示会议主题（默认） 1：隐藏会议主题 |
| reservDevices | 否 | int | 选了会议室时候，设备上是否显示会议 0：显示（默认），1：不显示 |
| cycle | 否 | string | 是否是周期会议，0：否，1：是 |
| repeatEndDate | 否 | int | 周期会议截止时间,秒 |
| cycleRole | 否 | Object | —-周期规则—- |
| composeRoomList | 否 | Object | 会议室信息， |
cycleRole结构
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| frequency | 否 | string | 重复频率，日/周/月, "daily","weekly","monthly" |
| interval | 否 | int | 间隔次数 |
| byday | 否 | string | 哪一天，MO,TU,WE,TH,FR,SA,SU |
| bymonthday | 否 | string | 日期，当frequency=monthly 时候，定义 |
cycleRole参数示例：
"cycleRole":{
"frequency":"weekly",
"interval":1,
"byday":"MO,WE"
}
"cycleRole":{
"frequency":"monthly",
"interval":1,
"bymonthday":"1,17,19"
}
composeRoomList结构
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| roomId | 否 | int | 会议室id |
| isMainRoom | 否 | int | 会议室类型，0：默认值，1：主会场，2：分会场 |
composeRoomList参数示例：
"composeRoomList":[
{
"roomId":6518
},
{
"roomId":6515,
"isMainRoom":1
}]
3. 示例
传参示例
{
"composeRoomList": [ {
"roomId":10935,
"isMainRoom":1
}],
"userId" : 88415897,
"sessionId":"8f2458beaa42aaaadfb74ec84fdd6efc2f0af7ee",
"starttime":"2021-09-15 19:00:00",
"title" :"裴秀月测试222",
"length" : 30,
"liveOpenFlag":0,
"livePassword":"",
"hardwareVideo":1,
"autoVideo":2
}
返回示例
{
"status": 0,
"result": {
"conferenceId": "239720077",
"pcode1": "201501000037436023",
"pcode2": "201501000037436024",
"billingcode": "95397828",
"eventId": 566973,
"attendeeJoinUrl": "https://mtest.qsh1.cn/k/mkj17hrk9ro",
"hostJoinUrl": "https://mtest.qsh1.cn/k/mkj17qgDjHq",
"wcallurl": "http://meetservicem.quanshi.com/m-wcall/?pcode=55394f578ba0d686c588b2be690a659ebebd0431843c5bb7048a7112c1410c39&env=E&billingcode=afad5c863ec9884d7e9545b08ce0b4e0&summit=1&prod=meetnow&uc_lang=cn&callin",
"userId": 88610849,
"createAccount": "pxytest24@pxy.quanshi.com",
"hostName": "pxytest24",
"hostMobile": "",
"startTime": "2022-06-09 18:30:00",
"endTime": "2022-06-09 19:00:00",
"length": 30,
"status": 1,
"title": "test123",
"h323Ip": [
"192.168.37.91"
],
"confMode": 1,
"livePullUrl": "https://ltest.qsh1.cn/activity/gdQ8Rz4",
"livePullPwd": ""
},
"request_id": "confopenapiserver-10.1.89.6-1654750810.193299000.81",
"reqid": "confopenapiserver-10.1.89.6-1654750810.193299000.81",
"timestamp": 1654750810208,
"request_duration": "1.6250929s"
}
4. 返回参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| status | int | 0:成功，非0失败 |
| result | json字符串 | 预约会议返回的结果 |
返回result参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| conferenceId | string | 预约会议ID |
| eventId | string | 预约会议对应的日程ID |
| pcode1 | string | 会议主持人密码 |
| pcode2 | string | 会议参会人密码 |
| userId | uint64 | 主持人userId |
| title | string | 会议标题 |
| billingCode | string | 会议billingCode |
| startTime | string | 会议开始时间 |
| endTime | string | 会议结束时间 |
| length | int64 | 会议时长 |
| hostName | string | 主持人姓名 |
| hostJoinUrl | string | 主持人入会连接 |
| attendeeJoinUrl | string | 参会人入会链接 |
| hostMobile | string | 主持人手机 |
| h323Ip | array | 硬件视频ip地址,数组类型 |
| wcallUrl | string | 电话会议入会连接 |
| livePullUrl | string | 直播连接 |
| livePullPwd | string | 直播密码 |
备注
- 更多返回错误代码请看首页的错误代码描述
