获取签到列表

最近更新时间:2024-07-08 11:48:53

我的收藏

接口描述

描述:会中会议创建者和主持人可以查询会议签到列表,会外会议创建者可以查询签到列表。
请求方式:GET
鉴权方式:JWT 鉴权,OAuth2.0 鉴权
权限点:会议管理
接口请求域名:
https://api.meeting.qq.com/v1/meetings/sign-in/list


输入参数

参数名称
是否必须
参数类型
参数描述
meeting_id
String
会议ID
operator_id_type
Integer
操作者 ID 的类型:
1:userid
2:openid
4:ms_open_id
operator_id
String
操作者 ID。operator_id 必须与 operator_id_type 配合使用。根据 operator_id_type 的值,operator_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
page_size
Integer
分页大小,默认值为10,最大为20。
page
Integer
页码,从1开始,默认值为1。

输出参数

参数名称
是否必须
参数类型
参数描述
sign_in_list
SignInInfo 对象列表
签到列表。
total_count
Integer
数据总条数。
total_page
Integer
总页数。
current_page
Integer
当前页码。
current_size
Integer
当前页数据条数。

SignInInfo 对象

参数名称
是否必须
参数类型
参数描述
sign_in_id
String
签到 ID。
start_time
String
签到开始时间戳(秒)。
sign_in_specification
String
签到说明。
sign_in_status
Integer
签到状态:
0:未开始
1:进行中
2:已结束

错误码列表

状态码
错误码
错误描述
500
190001
存在未注册的用户。
500
190310
每分钟总接口调用次数超过限制。
500
503
获取用户信息失败。
500
101
无权限操作,必须为会议创建者。
500
102
无权限操作,必须为会议主持人或创建者。
500
501
获取会议信息失败。
400
190004
参数非法,请对照接口文档检查您的参数。

示例

输入示例

GET
https://api.meeting.qq.com/v1/meetings/sign-in/list?meeting_id=123456789&operator_id_type=1&operator_id=test_operator_id&page=1&page_size=20&instanceid=2

输出示例

{
"total_count": 1,
"current_size": 20,
"total_page": 1,
"current_page": 1,
"sign_in_list": [
{
"sign_in_id": "S42CD414A-6EBD-XXXX-XXXX-C6437FC76741",
"start_time": 1684315462,
"sign_in_specification": "test_sign_in",
"sign_in_status": 2
}
]
}