创建用户专属参会链接

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

我的收藏

接口描述

描述
使用该接口,可用 customer_data 进行区分,为一场会议生成多个会议链接。通过用户入会、用户进入等候室等事件,或通过获取等候室成员列表的 API 查询到该参数。
一场会议最多支持创建300个专属参会链接。
该接口不支持个人会议号会议、网络研讨会(Webinar)。支持企业品牌化链接。
参会者腾讯会议客户端版本需大于等于 3.2.0。
暂不支持 OAuth 2.0 鉴权方式访问。
请求方式:POST
接口请求域名
https://api.meeting.qq.com/v1/meetings/customer-short-url


输入参数

HTTP 请求头公共参数请参见签名验证章节的 公共参数说明
参数名称
必选
参数类型
参数描述
meeting_id
String
会议 ID。
customer_data
String
用户专属字段,长度不超过256 字节。

输出参数

参数名称
参数类型
参数描述
meeting_short_url_customer_data
CustomerData 对象
用户专属参会链接对象。

CustomerData 对象

参数名称
参数类型
参数描述
customer_data
String
用户专属字段。
meeting_short_url
String
用户专属参会链接。

错误码列表

状态码
错误码
错误描述
400
202002
创建自定义短链失败。
400
190004
参数非法,请对照接口文档检查您的参数。
500
9042
无权限进行该操作,建议检查操作者身份或资源归属。
500
202005
该会议专属链接数量已超过限制,请联系客服解决。

示例

输入示例

POST https://api.meeting.qq.com/v1/meetings/customer-short-url
{
"customer_data":"test",
"meeting_id":"7567173273889276131"
}

输出示例

{
"meeting_short_url_customer_data":
{
"customer_data":"test",
"meeting_short_url":"https://meeting.tencent.com/dm/jCTxxxxxxx8C"
}
}