接口描述
描述:当账户类型为企业版时,可查询企业下可发起会议的成员列表。不支持 OAuth2.0 鉴权访问。
请求方式:GET
自建应用权限点:查看企业资源,管理企业资源。
接口请求域名:
https://api.meeting.qq.com/v1/corp-resource/book-meeting/authorized-users?operator_userid={operator_userid}&page={page}&page_size={page_size}
输入参数
参数名称 | 必选 | 参数类型 | 参数描述 |
operator_userid | 是 | String | 操作者用户 ID,必须为企业下具有操作资源权限的注册用户。 |
page | 否 | Integer | 当前页,从1开始,默认为1。 |
page_size | 否 | Integer | 分页大小,默认为20,不超过20。 |
media_set_type | 否 | Integer | 会议类型,仅提供给支持混合云的企业,默认值为0。 0:公网会议 1:专网会议 注意:若用户所属企业未配置混合云,则设置专网会议相关接口调用失败。 |
search_type | 否 | String | 查询维度,以逗号分隔指定。 1:用户维度 2:部门维度 例如:想要获取部门列表和用户列表,则传入“1,2”。默认只返回用户列表。 |
输出参数
成功返回以下参数:
参数名称 | 参数类型 | 参数描述 |
current_page | Integer | 当前页。 |
current_size | Integer | 当前页实际大小。 |
total_count | Integer | 数据总条数。 |
total_page | Integer | 数据总页数。 |
authorized_users | AuthorizedUsers 对象数组 | 企业下具有发起会议权限的成员列表。 |
authorized_departments | AuthorizedDepartments 对象数组 | 企业下具有发起会议权限的部门列表。 |
AuthorizedUsers 对象
参数名称 | 参数类型 | 参数描述 |
userid | String | 企业成员 ID。 |
user_name | String | 成员名称。 |
phone | String | 手机号码。 |
AuthorizedDepartments 对象
参数名称 | 参数类型 | 参数描述 |
department_id | String | 部门 ID。 |
department_name | String | 部门名称。 |
错误码列表
状态码 | 错误码 | 错误描述 |
400 | 190004 | 参数非法,请对照接口文档检查您的参数。 |
500 | 190440 | 仅企业版和教育版企业有权限操作。 |
500 | 190439 | 企业状态异常,场景: 1:企业非商业版与企业版 2:企业信息已过期或已被删除 |
500 | 403 | 没有资源操作权限。 |
500 | 41 | 网络错误,请稍后重试。 |
示例
输入示例
GEThttps://api.meeting.qq.com/v1/corp-resource/book-meeting/authorized-users?operator_userid=meeting4529091&page=1&page_size=2
输出示例
{"total_count": 5,"total_page": 3,"current_page": 1,"current_size": 2,"authorized_users": [{"userid": "meeting4529091","user_name": "austin","phone": "18627092823"}, {"userid": "meeting4529099","user_name": "tester1","phone": "18045218739"}]}