接口描述
描述:
可以获取指定会议的所有专属参会链接及 customer_data。
参会者腾讯会议客户端版本需大于等于 3.2.0。
暂不支持 OAuth 2.0 鉴权方式访问。
请求方式:GET
接口请求域名:
https://api.meeting.qq.com/v1/webinars/customer-short-url?meeting_id=1111&page_size=10&page=1&operator_id={operator_id}&operator_id_type={operator_id_type}
输入参数
参数名称 | 必选 | 参数类型 | 参数描述 |
meeting_id | 是 | String | 会议的唯一 ID。 |
page_size | 是 | Int | 分页大小,默认10,最大50。 |
page | 是 | Int | 页码,从1开始。 |
operator_id | 是 | String | 操作者 ID。 operator_id 必须与 operator_id_type 配合使用。根据 operator_id_type 的值,operator_id 代表不同类型。 |
operator_id_type | 是 | Integer | 操作者 ID 的类型: 1:userid |
输出参数
参数名称 | 参数类型 | 参数描述 |
webinar_short_url_customer_data | CustomerData 对象列表 | 用户专属参会链接对象。 |
current_page | Number | 分页查询返回当前页码。 |
current_size | Number | 分页查询返回单页数据条数。 |
total_count | Number | 分页查询返回数据总数。 |
total_page | Number | 分页查询返回分页总数。 |
CustomerData 对象
参数名称 | 参数类型 | 参数描述 |
customer_data | String | 用户专属字段。 |
webinar_short_url | String | 用户专属参会链接。 |
is_webinar_guest | Uint32 | 1:嘉宾;则通过链接入会的用户视为嘉宾。 2:观众,则通过链接入会的用户视为观众。 |
is_join_meeting | String | 1:打开链接立即入会。 2:打开链接会进入嘉宾邀请页面或会议详情页(会议开启报名该参数失效) |
示例
输入示例
GET https://api.meeting.qq.com/v1/webinars/customer-short-url?meeting_id=7567173xxxxxxxx6131&page_size=10&page=1&operator_id=14411xxxxxxxxxx002&operator_id_type=1
输出示例
{"webinar_short_url_customer_data":[{"customer_data":"test","webinar_short_url":"https://meeting.tencent.com/dm/jCTxxxxxxx8C","is_webinar_guest":1,"is_join_meeting":1},{"customer_data":"test2","webinar_short_url":"https://meeting.tencent.com/dm/jCTxxxxxxx8D","is_webinar_guest":1,"is_join_meeting":1}],"current_page":1,"current_size":2,"total_count":2,"total_page":1}