获取 Webinar 专属参会链接

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

我的收藏

接口描述

描述:
可以获取指定会议的所有专属参会链接及 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


输入参数

HTTP 请求头公共参数请参见签名验证章节的 公共参数说明
参数名称
必选
参数类型
参数描述
meeting_id
String
会议的唯一 ID。
page_size
Int
分页大小,默认10,最大50。
page
Int
页码,从1开始。

输出参数

参数名称
参数类型
参数描述
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

输出示例

{
"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
}