Logo
Section 1 / 2

列出对话和用户

学习如何使用 Slack API 调用来获取工作区中用户的数据。

导入

列出对话和用户

学习如何使用 Slack API 调用来获取工作区中用户的数据。

概述

本节课中，我们将了解以下两个端点：

  1. users.conversations：此端点列出请求用户可访问的对话。
  2. users.list：此端点列出 Slack 团队中的所有用户。

获取对话列表

要获取对话列表，我们将访问 https://slack.com/api/users.conversations 端点。通过该端点，我们可以了解应用程序参与的对话数量。

users.conversations 端点的一些重要查询参数如下：

参数类型分类描述
tokentoken必需认证令牌携带了控制不同 Slack 应用和 API 使用权限所需的权限范围。我们通常将这些令牌作为 HTTP Authorization 头部或 POST 参数传递。
cursorstring可选该参数是一串字符，用于“指向”下一页数据。通过将 cursor 参数设置为前一次请求响应中的 response_metadata 所返回的 next_cursor 值，实现对数据集合的分页。
limitstring可选返回的最大项目数量。

让我们调用 users.conversations 端点。点击“运行”按钮，即可获取应用程序可访问的对话列表。

1import requests
2import json
3
4url = "https://slack.com/api/users.conversations"
5headers = {
6    'Authorization': 'Bearer {{Token}}',
7    'Content-Type': 'application/x-www-form-urlencoded',
8}
9
10response = requests.get(url, headers=headers)
11print(json.dumps(response.json(), indent=4))
  • 第 4 行：我们调用 users.conversations 端点，获取应用程序（或已认证用户）参与的对话列表。

获取用户列表

要获取用户列表，我们将访问 https://slack.com/api/users.list 端点。API 将返回指定工作区中的所有用户列表。

users.list 端点的一些重要查询参数如下：

参数类型分类描述
tokentoken必需认证令牌携带了控制不同 Slack 应用和 API 使用权限所需的权限范围。我们通常将这些令牌作为 HTTP Authorization 头部或 POST 参数传递。
cursorstring可选该参数是一串字符，用于“指向”下一页数据。通过将 cursor 参数设置为前一次请求响应中的 response_metadata 所返回的 next_cursor 值，实现对数据集合的分页。
limitstring可选返回的最大项目数量。

让我们调用 users.list 端点。点击“运行”按钮，即可收到工作区中用户列表的响应。

1import requests
2import json
3
4url = "https://slack.com/api/users.list"
5headers = {
6    'Authorization': 'Bearer {{Token}}',
7    'Content-Type': 'application/x-www-form-urlencoded',
8}
9
10response = requests.get(url, headers=headers)
11print(json.dumps(response.json(), indent=4))
  • 第 4 行：我们调用 users.list 端点，获取当前或曾经存在于工作区中的用户列表。

文件管理

操作在线状态