接口描述
描述:在指定网络研讨会(Webinar)中导入报名信息。企业 secret 鉴权用户可通过同企业下用户 userid 和手机号导入报名信息,OAuth2.0 鉴权用户能通过用户 open_id,与应用同企业下的 userid 以及手机号导入报名信息。用户必须是注册用户,请求头部 X-TC-Registered 字段必须传入为1。商业版单场会议导入上限1000条,企业版单场会议导入上限4000条。如需提升,请 联系我们。请求方式:POST接口请求域名:
https://api.meeting.qq.com/v1/webinars/{meeting_id}/enroll/import
输入参数
operator_id |
String |
必须 |
操作者 ID。会议创建者可以导入报名信息。operator_id 必须与 operator_id_type 配合使用。根据 operator_id_type 的值,operator_id 代表不同类型。operator_id_type=2,operator_id 必须和公共参数的 openid 一致。使用 OAuth 公参鉴权后不能使用 userid 为入参。 |
operator_id_type |
Integer |
必须 |
操作者 ID 的类型:1:userid2:open_id |
instanceid |
Integer |
必须 |
用户的终端设备类型:0:PSTN1:PC2:Mac3:Android4:iOS5:Web6:iPad7:Android Pad8:小程序9:voip、sip 设备10:linux20:Rooms for Touch Windows21:Rooms for Touch MacOS22:Rooms for Touch Android30:Controller for Touch Windows32:Controller for Touch Android33:Controller for Touch iOS |
enroll_list |
Enroll 对象数组 |
必须 |
报名对象列表。 |
Enroll 对象
open_id |
String |
非必须 |
OAuth 授权用户 ID。导入报名对象支持本企业(JWT 模式)或应用同企业(OAuth 模式)内 userid、授权用户的 openid、phone_number 三种形式,三者必填其一。如果都传了以 openid 为准。JWT 鉴权方式无法使用 open_id 导入报名。 |
userid |
String |
非必须 |
企业内的用户的唯一 ID。导入报名对象支持本企业(JWT 模式)或应用同企业(OAuth 模式)内 userid、授权用户的 openid、phone_number 三种形式,三者必填其一。 |
area |
String |
非必须 |
国家/地区代码。若使用 phone_number 的方式导入,该字段必填(例如:中国传86,不是+86)。 |
phone_number |
String |
非必须 |
手机号。导入报名对象支持本企业(JWT 模式)或应用同企业(OAuth 模式)内 userid、授权用户的 openid、phone_number 三种形式,三者必填其一。 |
nick_name |
String |
非必须 |
报名的昵称。此处的修改不会影响会中展示的昵称,仅展示在导出的报名信息。 |
输出参数
total_count |
Integer |
成功导入的报名信息条数。 |
enroll_list |
Enrol 对象数组 |
报名对象列表。 |
user_non_registered |
String 数组 |
通过 userid 方式导入时,本企业内未注册用户。返回未注册的 userid 数组。 |
Enrol 对象
enroll_id |
Integer |
报名 ID。 |
open_id |
String |
OAuth 授权用户 ID。导入报名对象支持本企业(JWT 模式)或应用同企业(OAuth 模式)内 userid、授权用户的 openid、phone_number 三种形式,三者必填其一。 |
userid |
String |
企业内的用户的唯一 ID。导入报名对象支持本企业(JWT 模式)或应用同企业(OAuth 模式)内 userid、授权用户的 openid、phone_number 三种形式,三者必填其一。 |
area |
String |
国家/地区代码。若使用 phone_number 的方式导入,该字段必填(例如:中国传86,不是+86)。 |
phone_number |
String |
手机号。导入报名对象支持本企业(JWT 模式)或应用同企业(OAuth 模式)内 userid、授权用户的 openid、phone_number 三种形式,三者必填其一。 |
nick_name |
String |
报名的昵称。 |
enroll_code |
String |
报名码,用于电话入会的凭证。 |
示例
输入示例
POST https://api.meeting.qq.com/v1/webinars/100001/enroll/import{ "instanceid": 1, "operator_id": "user1", "operator_id_type":1, "enroll_list": [{ "area":"86", "phone_number":"13612111111" }, { "userid":"123" }]}
输出示例
{ "total_count": 1, "enroll_list": [{ "userid":"user1", "area":"86", "phone_number":"13612111111", "nick_name":"ccc", "enroll_code":"111", "enroll_id":1351111, "open_id":"" }], "user_non_registered":["123"]}
对腾讯办公协同的解决方案有疑惑?想了解解决方案收费? 联系解决方案专家
腾讯云限时活动1折起,即将结束: 马上收藏
同尘科技为腾讯云授权服务中心,购买腾讯云享受折上折,更有现金返利:同意关联,立享优惠
阿里云解决方案也看看?: 点击对比阿里云的解决方案