有奖捉虫:办公协同&微信生态&物联网文档专题 HOT

接口描述

描述:根据会议 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
设置选人票失败,请稍后重试。

示例

输入示例

POST
https://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"
}]
}

输出示例

{}