如何通过JIRA Cloud REST API获取用户总数量

通用分页遍历法（兼容所有JIRA版本） #

该方法不依赖接口返回总数字段，是适配性最高的实现方式：

• 先确认你调用的用户查询接口支持startAt分页参数，JIRA官方提供的所有用户列表类接口均支持该参数
• 调整请求的maxResults参数到实例允许的最大值（默认最大可设为1000，比默认的50大幅减少请求次数）
• 初始化startAt = 0、totalUserCount = 0两个变量
• 循环发起请求，每次携带当前的startAt值，拿到响应后：
  1. 累加本次返回的用户列表长度到totalUserCount
  2. 如果本次返回的列表长度小于你设置的maxResults，说明已经拉到最后一页，终止循环
• 循环结束后totalUserCount就是平台全量用户总数

注意：该方法返回的用户范围和你调用API使用的账号权限一致，要获取全量用户需要给API账号分配浏览用户全局权限。

版本专属快捷方案 #

JIRA Server/Data Center 版本 #

直接调用/rest/api/2/user/count接口，该接口会直接返回全量用户总数，无需分页遍历，请求示例：

GET /rest/api/2/user/count

JIRA Cloud 版本 #

切换使用V3版用户查询接口/rest/api/3/users/search，该接口会在响应头返回X-Total-Count字段，直接读取该字段即可得到用户总数，无需全量分页。

内容的提问来源于stack exchange，提问作者Aniruddha Gayake