接口描述
描述:会中会议创建者和主持人可以查询会议签到列表,会外会议创建者可以查询签到列表。
请求方式:GET
鉴权方式:AK/SK 鉴权、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 | 参数非法,请对照接口文档检查您的参数。 |
示例
输入示例
GEThttps://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}]}