腾讯会议
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 腾讯会议 > 开放平台文档 > 服务端 API > REST APIs > 会议管理 > 导入会议报名信息

导入会议报名信息

最近更新时间：2024-04-23 16:12:01

我的收藏

本页目录：

接口描述

描述：
指定会议中导入报名信息。
企业 secret 鉴权用户可通过同企业下用户 userid 和手机号导入报名信息，OAuth2.0 鉴权用户能通过用户 open_id，与应用同企业下的 userid 以及手机号导入报名信息。
用户必须是注册用户，请求头部 X-TC-Registered 字段必须传入为1。
商业版单场会议导入上限1000条，企业版单场会议导入上限4000条。如需提升，请 联系我们。
请求方式：POST
接口请求域名：
https://api.meeting.qq.com/v1/meetings/{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：userid
2：open_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
enroll_list
Enroll 对象数组
必须
报名对象列表。

Enroll 对象

参数名称
参数类型
是否必须
参数描述
open_id
String
非必须
OAuth 授权用户 ID。
导入报名对象支持本企业（JWT 模式）或应用同企业（OAuth 模式）内 userid、授权用户的 openid、phone_number 三种形式，三者必填其一。
如果都传了以 openid 为准（优先级为：openid > userid > phone_number）。
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
报名码，用于电话入会的凭证。

错误码列表

状态码
错误码
错误描述
400
190004
参数非法，请对照接口文档检查您的参数。
500
190310
每分钟总接口调用次数超过限制。
500
190001
存在未注册的用户。
500
107
查询权限不足。
500
101
会议未开启报名。

示例

输入示例

POST
https://api.meeting.qq.com/v1/meetings/100001/enroll/import
{
    "instanceid": 2,
    "operator_id": "user1",
    "operator_id_type": 1,
    "enroll_list": [
        {
            "area": "86",
            "phone_number": "13612113333",
            "nike_name":"asdn"
        }
    ]
}

输出示例

{
    "total_count": 1,
    "enroll_list": [
        {
            "userid": "",
            "area": "86",
            "phone_number": "13612113333",
            "nick_name": "asdn",
            "enroll_code": "1112",
            "enroll_id": 1386442,
            "open_id": ""
        }
    ]
}

中国站