编辑云会议
编辑云会议(支持会议室)
1. 接口描述
接口名称:
/confopenapi/room/updateReservConference
发送方式:
POST
参数格式:
accept: application/json;content-type: application/json
2. 输入参数
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
eventId | 否 | int | eventId ,和conferenceId 2选1 ,现场会用eventId |
conferenceId | 否 | string | 会议Id ,和eventId 2选1 |
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. 示例
传参示例
{
"eventId":524331,
"conferenceId":"239418513",
"composeRoomList": [ {
"roomId":10935,
"isMainRoom":1
}],
"userId" : 88415897,
"sessionId":"8f2458beaa42aaaadfb74ec84fdd6efc2f0af7ee",
"starttime":"2021-09-15 18:30:00",
"title" :"裴秀月测试222",
"length" : 40,
"liveOpenFlag":0,
"livePassword":""
}
返回示例
{
"status": 0,
"result": {
"conferenceId": "239719542",
"pcode1": "201501000037435195",
"pcode2": "201501000037435196",
"billingcode": "95397414",
"eventId": 566458,
"attendeeJoinUrl": "https://mtest.qsh1.cn/k/mkIY1u50UoT",
"hostJoinUrl": "https://mtest.qsh1.cn/k/mkIY1k0500a",
"wcallurl": "http://meetservicem.quanshi.com/m-wcall/?pcode=f8b36deb06a1d23f7c427d98cfff5dd7bb57d06166e0f7237b8aa066add82995&env=E&billingcode=5caa023e06553ad1d5100226ba858eab&summit=1&prod=meetnow&uc_lang=cn&callin",
"userId": 88610849,
"createAccount": "pxytest24@pxy.quanshi.com",
"hostName": "pxytest24",
"hostMobile": "",
"startTime": "2022-06-07 15:30:00",
"endTime": "2022-06-07 16:00:00",
"length": 30,
"status": 1,
"title": "裴秀月测试222",
"h323Ip": [
"192.168.37.91"
],
"confMode": 1,
"livePullUrl":"",
"livePullPwd":""
},
"request_id": "confopenapiserver-172.10.248.48-1654580505.936164946.540",
"reqid": "confopenapiserver-172.10.248.48-1654580505.936164946.540",
"timestamp": 1654580505936,
"request_duration": "812.761884ms"
}
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 | 直播密码 |
备注
- 更多返回错误代码请看首页的错误代码描述