接口描述
描述:根据会议 ID 设置邀请成员,只有会议的创建者才有权限设置。最多可以设置2000名邀请者。
说明:
本接口为覆盖式设置。
请求方式:PUT
接口请求域名:
https://api.meeting.qq.com/v1/meetings/{meeting_id}/invitees
输入参数
参数名称 | 必选 | 参数类型 | 参数描述 |
meeting_id | 是 | String | 会议 ID。 |
userid | 是 | String | 调用方用于标示用户的唯一 ID(企业内部请使用企业唯一用户标识;OAuth2.0 鉴权用户请使用 openId)。 企业唯一用户标识说明: 1:企业对接 SSO 时使用的员工唯一标识 ID。 2:企业调用创建用户接口时传递的 userid 参数。 |
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 |
invitees | 否 | User 对象数组 | 会议邀请的参会者(不送或传空数组会清空受邀成员列表,最大支持2000人)。 |
User 对象
参数名称 | 必选 | 参数类型 | 参数描述 |
userid | 是 | String | 调用方用于标示用户的唯一 ID,仅支持邀请与会议创建者同企业的成员(企业内部请使用企业唯一用户标识;OAuth2.0 鉴权用户请使用 openId)。 企业唯一用户标识说明: 企业对接 SSO 时使用的员工唯一标识 ID。 企业调用创建用户接口时传递的 userid 参数。 |
输出参数
参数名称 | 参数类型 | 参数描述 |
user_non_registered | String 数组 | 邀请的参会者中未注册用户。 |
错误码列表
状态码 | 错误码 | 错误描述 |
400 | 190004 | 参数非法,请对照接口文档检查您的参数。 |
500 | 190431 | 创建会议嘉宾失败。 |
403 | 9042 | 无权限进行该操作,建议检查操作者身份或资源归属。 |
400 | 190457 | 会议不存在, 请核对 meeting_id。 |
500 | 190001 | 存在未注册的用户。 |
500 | 190308 | 查询 tinyID 失败。 |
500 | 500041 | 设置选人票失败,请稍后重试。 |
示例
输入示例
POSThttps://api.meeting.qq.com//v1/meetings/2594xxxxxxxxxx9143/invitees{"userid": "testinvitees_01xxxxxxxxxx061778","instanceid": 1,"invitees": [{"userid": "testinvitees_116xxxxxxxxx98397"},{"userid": "testinvitees_2163xxxxxxxxxx898"},{"userid": "testinvitees_3163xxxxxxxxxx971"},{"userid": "testinvitees_416xxxxxxxxxx4715"},{"userid": "testinvitees_516xxxxxxxxxx8371"}]}
输出示例
{}