创建云会议
创建云会议(支持会议室)
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 | 直播密码 |
备注
- 更多返回错误代码请看首页的错误代码描述