执行批量注册 - Zoom API 中文版

一次注册最多30个注册人参加需要 [注册] 的预定网络研讨会 (https://support.zoom.us/hc/en-us/articles/204619915-Scheduling-a-webinar-with-registration)。

** 先决条件: **

网络研讨会主持人必须是获得许可的用户。

网络研讨会应该是 “5” 类型，一个预定的网络研讨会。此API不支持其他类型的网络研讨会。

** 范围: ** 'webinar:master'

** [速率限制标签](https://marketplace.zoom.us/docs/api参考/速率限制 # 速率限制):** “沉重”

请求参数

Path 参数

webinarId

string

必需

网络研讨会的唯一标识符。

accountId

string

帐户的唯一标识符。

必需

Body 参数application/json

registrants

array [object {3}]

可选

last_name

string

注册人的姓氏。

可选

示例值:

Chill

first_name

string

注册人的名字。

必需

示例值:

Jill

string <email>

必需

注册人的电子邮件地址。

示例值:

jchill@example.com

auto_approve

boolean

可选

如果安排的会议使用approval_type '1' (手动批准)，但您希望自动批准通过此API添加的注册人，请将此字段的值设置为 'true'。

您 ** 不能 ** 使用此字段更改最初安排为approval_type为 “0” (自动批准) 的会议的批准设置。

示例值:

true

示例

{
    "registrants": [
        {
            "last_name": "Chill",
            "first_name": "Jill",
            "email": "jchill@example.com"
        }
    ],
    "auto_approve": true
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢201** HTTP状态码: ** '200' ** 确定 ** 注册人已添加。

application/json

Body

registrants

array [object {3}]

可选

join_url

string

可选

注册人可以加入网络研讨会的唯一URL。

示例值:

https://example.com/j/11111

registrant_id

string

可选

注册人的唯一标识符。

示例值:

-rOym-zdTHOdbT3A7u7u5g

string

可选

注册人的电子邮件地址。

示例值:

jchill@example.com

示例

{
    "registrants": [
        {
            "join_url": "https://example.com/j/11111",
            "registrant_id": "-rOym-zdTHOdbT3A7u7u5g",
            "email": "jchill@example.com"
        }
    ]
}

🟠400** HTTP状态代码: ** '400' 错误的请求 ** 错误代码: ** '200' 缺少网络研讨会计划。您必须订阅网络研讨会计划并为 “{0}” 用户启用网络研讨会才能执行此操作。 ** 错误代码: ** '300' 此API只能用于预定的网络研讨会 (类型5)。其他网络研讨会类型不支持批量注册。 ** 错误代码: ** '3038' 网络研讨会结束了。您现在无法注册。如果您有任何问题，请联系网络研讨会主持人。 ** 错误码: **

🟠404** HTTP状态代码: ** '404' 未找到 ** 错误代码: ** '3001' 网络研讨会不存在: {0}。 ** 错误代码: ** '3043' 网络研讨会已达到最大与会者人数。 ** 错误代码: ** '404' 尚未为此会议启用注册: {meetingId}。

🟠429** HTTP状态代码: ** '429' 请求太多