接口描述
描述:
对成功预定的会议添加会议背景,支持多个背景图片的添加。一场会议最多添加7个背景,且仅支持不超过10MB大小的 PNG 格式图片,分辨率最小为1920*1080。添加成功返回新增的会议背景信息。目前暂不支持 OAuth2.0 鉴权访问。
背景图片上传方式为异步上传,您可以通过订阅 素材上传结果 获得上传结果通知。
请求方式:POST
接口请求域名:
https://api.meeting.qq.com/v1/meetings/{meeting_id}/backgrounds
输入参数
参数名称 | 必选 | 参数类型 | 参数描述 |
meeting_id | 是 | String | 会议 ID。 |
userid | 是 | String | 会议创建者 ID。 |
instanceid | 是 | Integer | 用户的终端设备类型: 0:PSTN 1:PC 2:Mac 3:Android 4:iOS 5:Web 6:iPad 7:Android Pad 8:小程序 9:voip、sip 设备 10:Linux 20:Rooms for Touch Windows 21:Rooms for Touch MacOS 22:Rooms for Touch Android 30:Controller for Touch Windows 32:Controller for Touch Android 33:Controller for Touch iOS |
default_image_order | 否 | Integer | 图片列表中会议需要使用的背景图片序号,从1开始计数。 |
image_list | 是 | ImageList 对象数组 | 图片对象列表。 |
ImageList 对象
参数名称 | 必选 | 参数类型 | 参数描述 |
image_md5 | 是 | String | 背景图片 MD5(图片内容 MD5 的十六进制表示)。 |
image_url | 是 | String | 背景图片 URL。 |
输出参数
参数名称 | 参数类型 | 参数描述 |
background_number | Integer | 背景数量。 |
selected_background_id | String | 会议应用的背景 ID。 |
background_list | BackgroundList 对象数组 | 背景对象列表。 |
BackgroundList 对象
参数名称 | 参数类型 | 参数描述 |
background_id | String | 背景 ID。 |
image_md5 | String | 背景图片 MD5(图片内容 MD5 的十六进制表示)。 |
错误码列表
状态码 | 错误码 | 错误描述 |
500 | 20014 | 背景图片大小非法。 |
400 | 20026 | 应用背景序号超出范围。 |
400 | 190004 | 参数非法,请对照接口文档检查您的参数。 |
400 | 20018 | 会议背景数量超过最大值。 |
500 | 202001 | 会议明细获取失败,请检查会议是否存在。 |
500 | 20013 | 背景图片 URL 非法。 |
500 | 9042 | 没有权限。 |
500 | 190001 | 存在未注册的用户。 |
示例
输入示例
POSThttps://api.meeting.qq.com/v1/meetings/6524541286408448530/backgrounds{"userid":"creator1","instanceid":1,"default_image_order":2,"image_list":[{"image_md5":"c8c7xxxxxxxxxxxxxxxxxxxxxxxx8a2e","image_url":"https://xxxxxx.cos.myqcloud.com/flower.png"},{"image_url":"https://xxxxxx.cos.myqcloud.com/cat.png","image_md5":"c3daxxxxxxxxxxxxxxxxxxxxxxxx62a4"}]}
输出示例
{"background_number":2,"selected_background_id":"f1fexxxxxxxxxxxxxxxxxxxxxxxx2d59","background_list":[{"background_id":"ca4exxxxxxxxxxxxxxxxxxxxxxxx6e93","image_md5":"c8c7xxxxxxxxxxxxxxxxxxxxxxxx8a2e"},{"background_id":"f1fexxxxxxxxxxxxxxxxxxxxxxxx2d59","image_md5":"c3daxxxxxxxxxxxxxxxxxxxxxxxx62a4"}]}