Slack团队ID绑定规则及两个用户列表接口响应差异咨询

关于团队ID与工作区的绑定关系、单工作区多团队支持 #

• Slack的团队ID（以T为前缀的字符串标识）和工作区是1:1强绑定关系，接口返回的team_id本质就是对应工作区的全局唯一标识，不存在同一个团队ID对应多个工作区的情况。
• 单个工作区内不支持创建多个独立团队。Slack产品迭代中早期的"团队"概念和当前的"工作区"定义完全等价，后续推出的Enterprise Grid企业版架构，是将多个独立工作区归属于同一个企业组织（Org，标识以E为前缀）下做统一管控，单个工作区本身始终对应唯一的团队标识，没有在工作区下拆分独立团队的设计。如果需要做人员分组权限管控，可以使用工作区内的用户组（User Group）、私有频道分区实现类似效果，但这类分组不属于独立的"团队"实体。

admin.users.list与users.list接口的响应差异 #

两个接口的定位、适用场景、返回内容存在本质区别，核心差异如下：

• 调用权限要求不同
  • admin.users.list属于企业管理员级接口，仅Enterprise Grid企业版的组织管理员/拥有者持有对应权限的token才可调用，普通免费/Pro/商务版工作区、普通用户身份调用会直接返回权限不足错误。
  • users.list是通用公开接口，只要是工作区的合法成员，持有对应工作区的有效用户token或机器人token即可调用，无企业版、管理员身份的强制要求，普通成员权限也可正常调用。
• 返回用户覆盖范围不同
  • admin.users.list返回的是整个企业组织下所有关联工作区的全量用户数据，并非单工作区用户，响应中会额外标注每个用户归属的工作区ID、企业级角色信息，支持按指定工作区做过滤查询。
  • users.list返回的仅为调用凭证所属的单个工作区/单个Slack团队内的所有用户，不会跨工作区拉取用户数据，返回的角色字段仅对应用户在当前工作区内的权限。
• 响应携带字段不同
  • admin.users.list会额外返回企业级管控相关字段：包括用户的企业级账号状态、跨工作区权限配置、合规标记、管理员配置的全量用户自定义属性等敏感管控字段。
  • users.list仅返回当前工作区内可见的用户公开字段：比如用户在当前工作区的昵称、工作区内可见的个人资料、当前工作区的角色等，不会返回企业级管控字段，普通权限调用者也无法拿到管理员专属的敏感配置字段。
• 分页规则不同
  • admin.users.list单页返回上限为100条，拉取全量数据必须通过cursor参数逐页翻取。
  • users.list单页返回上限为1000条，用户规模较小的工作区甚至可以单次请求拉完所有用户，分页逻辑更简单。

内容的提问来源于stack exchange，提问作者Rashmi Jyoti