Zoom Web API 的响应

Zoom Web API 提供了多种响应类型，包括 JSON、XML 等。开发者可以根据自己的需求选择合适的响应类型来解析 Zoom API 返回的数据。

响应格式

Zoom API 的响应是一个JSON格式的文本，其结构如下：

{
    "status_code": 200,
    "status_message": "OK",
    "data": {}
}

• status_code 表示请求的状态码，例如 200 表示请求成功，400 表示请求错误，500 表示服务器错误等。
• status_message 表示请求状态的描述信息。
• data 表示 Zoom API 返回的数据。

响应状态码

Zoom API 的响应状态码与 HTTP 状态码一致，如下表所示：

| 状态码 | 描述 | | -------| ---- | | 200 | 请求成功 | | 201 | 资源创建成功 | | 204 | 资源删除成功 | | 400 | 请求参数有误 | | 401 | 未授权访问 | | 403 | 访问被禁止 | | 404 | 资源不存在 | | 429 | 请求频率过快 | | 500 | 服务器内部错误 |

响应数据类型

Zoom API 返回的数据类型因接口而异。以下是常见的响应数据类型及其示例：

获取用户信息

请求：

GET /v2/users/{userId}

响应：

{
    "id": "string",
    "first_name": "string",
    "last_name": "string",
    "email": "string",
    "type": "2",
    "pmi": 123456789,
    "timezone": "string",
    "created_at": "string",
    "last_login_time": "string",
    "language": "string",
    "status": "active"    
}

获取会议列表

请求：

GET /v2/users/{userId}/meetings

响应：

{
  "page_count":2,
  "page_number":1,
  "page_size":30,
  "total_records":40,
  "meetings":[
      {
        "uuid":"UUID1",
        "id":2222222222,
        "host_id":"tX9xQKjZRt-lOji1JyMOgQ",
        "topic":"Michael's Meeting",
        "type":2,
        "start_time":"2019-11-11T09:00:00Z",
        "duration":30,
        "timezone":"America/Los_Angeles",
        "created_at":"2019-11-11T18:45:00Z",
        "join_url":"https://zoom.us/j/2222222222"
      },
      {
        "uuid":"UUID2",
        "id":4444444444,
        "host_id":"Dz6f1ohRQnG6iQrnz6FAug",
        "topic":"Jane's Meeting",
        "type":2,
        "start_time":"2019-11-11T11:45:00Z",
        "duration":45,
        "timezone":"America/Los_Angeles",
        "created_at":"2019-11-12T22:03:00Z",
        "join_url":"https://zoom.us/j/4444444444"
      }
  ]
}

响应解析

在调用 Zoom API 后，需要根据返回的 JSON 数据进行解析，以获取需要的信息。

解析 JSON 数据

import json
response = requests.get(url)
data = json.loads(response.text)['data']

解析 XML 数据

import xml.etree.ElementTree as ET
response = requests.get(url)
root = ET.fromstring(response.text)

参考链接

• Zoom Web API 文档