中望帐号
  1. 用户
中望帐号
  • 服务更新记录
  • 接入说明
  • 网关和规范
  • 客户端接入\变更申请
  • 全局返回码
  • 用户一致性
  • 用户消息推送
  • 授权认证
    • 获取服务配置
      GET
    • 获取用户授权code
      GET
    • 使用授权code兑换用户令牌
      POST
    • 刷新令牌
      POST
    • 受信客户端获取令牌
      POST
    • 密码模式获取用户令牌
      POST
  • 用户
    • 获取用户基本信息(OIDC)-不建议使用
      GET
    • 获取用户基本信息
      GET
    • 修改用户基本信息
      POST
    • 修改用户头像
      POST
    • 获取用户详细信息
      GET
    • 修改用户详细信息
      POST
    • 获取用户第三方绑定信息
      GET
    • 获取用户资讯接收设置
      GET
    • 结束会话(退出登录)
      GET
    • 获取客户端配置
      GET
    • 获取用户信息修改次数
      GET
    • 修改帐号安全信息
      GET
    • 获取用户当前IP信息
      GET
    • 发送验证码
      POST
  • 受信客户端接口
    • 用户
      • 获取用户GUID列表
        GET
      • 批量查询用户GUID
        POST
      • 批量获取用户详细信息
        POST
      • 批量获取用户第三方绑定信息
        POST
      • 通过第三方登录信息查询用户
        POST
      • 创建用户
        POST
      • 查询最近的登录记录
        GET
      • 增加用户第三方绑定信息
        POST
      • 批量修改用户详细信息
        POST
    • 企业
      • 刷新企业用户部门
    • 其他
      • 推送服务消息
  • OEM受信客户端
    • OEM授权认证对接说明
    • 获取OEM用户列表
    • 注册OEM用户
    • 更新OEM用户
    • 删除OEM用户
  • 管理后台
    • 用户
      • 获取用户列表
      • 申请导出用户数据
      • 获取导出的用户数据
      • 取消用户数据导出申请
      • 获取数据申请记录
      • 获取数据下载记录
      • 搜索用户
      • 获取用户部门名称链
      • 修改用户详细信息
      • 修改用户安全信息
      • 解绑用户手机号\邮箱\第三方
    • 角色
      • 获取角色组列表
      • 新建角色组
      • 更新角色组
      • 设置角色组管理员
      • 添加用户至角色组
      • 从角色组移除用户
      • 为用户分配可读权限
      • 取消用户可读权限
    • 企业
      • 创建\修改企业
      • 创建\修改企业第三方关联
  • 其他
    • 企微第三方用户关联
    • 企微回调
    • 获取客户端配置
    • 获取RSA公钥
  1. 用户

获取用户GUID列表

正式环境
https://accounts.zwsoft.cn
正式环境
https://accounts.zwsoft.cn
GET
/api/v1.0/users/guids
最后修改时间:2023-07-18 01:35:22
需要scope:ZMS.Users.Read
filter为json对象字符串的url全编码,过滤器中各字段为与关系,数组内各元素为或关系。不筛选的字段请赋null或不传入。
字段类型说明
fromClientarray[string]通过客户端注册的用户
userGuidarray[string]用户Guid
userNamearray[string]用户名
emailarray[string]用户邮箱
phonearray[string]用户手机号
hasEmailbool是否绑定邮箱,false时email字段无效
hasPhonebool是否绑定手机号,false时phone字段无效
accountStatearray[string]用户状态
正常=Normal
冻结=Freeze
锁定=Locked
externalarray[string]第三方账号,当前支持:
WeChat
Google
Facebook
Apple
WorkWeChat
JiaoJianTong
createBeforestring在此时间之前创建(包含)
createAfterstring在此时间之后创建(包含)
lastLoginBeforestring最后一次登录在此时间之前(包含)
lastLoginAfterstring最后一次登录在此时间之后(包含)
regionarray[string]最常登录IP区域,国家或地区代号
notRegionarray[string]排除最常登录IP区域,国家或地区代号
clientsarray[string]使用的服务
时间均为世界标准时,格式为:YYYY-MM-DDThh:mm:ss.zzzZ

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Query 参数
pageSize
integer 
可选
每页数量,1~1000,默认:50
示例值:
50
pageNum
integer 
可选
页码,由1起算,默认:1
示例值:
1
filter
string 
过滤条件
可选
force
string 
可选
是否强制刷新缓存,缓存时间为1小时
示例值:
false
Header 参数
Authorization
string 
必需

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://accounts.zwsoft.cn/api/v1.0/users/guids?pageSize=50&pageNum=1&filter=&force=false' \
--header 'Authorization;'

返回响应

🟢200成功
application/json
Body
totalNum
integer 
总数量
必需
pageSize
integer 
每页数量
必需
pageNum
integer 
当前页码
必需
status
integer 
返回码
必需
详情请查看全局返回码
message
string 
错误详细信息
必需
无错误时,返回:success
error
string  | null 
错误代号
必需
详情请查看全局返回码
data
array[string]
用户guid列表
必需
无数据时为空列表
示例
{
    "status": 0,
    "message": "success",
    "error": null,
    "totalNum": 12,
    "pageSize": 50,
    "pageNum": 1,
    "data": [
        "asjn-sad5-a184-asod-a51d-asik"
    ]
}
修改于 2023-07-18 01:35:22
上一页
发送验证码
下一页
批量查询用户GUID
Built with