中望帐号
  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列表
      • 批量查询用户GUID
      • 批量获取用户详细信息
      • 批量获取用户第三方绑定信息
      • 通过第三方登录信息查询用户
      • 创建用户
      • 查询最近的登录记录
      • 增加用户第三方绑定信息
      • 批量修改用户详细信息
    • 企业
      • 刷新企业用户部门
    • 其他
      • 推送服务消息
  • OEM受信客户端
    • OEM授权认证对接说明
    • 获取OEM用户列表
    • 注册OEM用户
    • 更新OEM用户
    • 删除OEM用户
  • 管理后台
    • 用户
      • 获取用户列表
        GET
      • 申请导出用户数据
        POST
      • 获取导出的用户数据
        GET
      • 取消用户数据导出申请
        DELETE
      • 获取数据申请记录
        GET
      • 获取数据下载记录
        GET
      • 搜索用户
        GET
      • 获取用户部门名称链
        GET
      • 修改用户详细信息
        POST
      • 修改用户安全信息
        POST
      • 解绑用户手机号\邮箱\第三方
        POST
    • 角色
      • 获取角色组列表
      • 新建角色组
      • 更新角色组
      • 设置角色组管理员
      • 添加用户至角色组
      • 从角色组移除用户
      • 为用户分配可读权限
      • 取消用户可读权限
    • 企业
      • 创建\修改企业
      • 创建\修改企业第三方关联
  • 其他
    • 企微第三方用户关联
    • 企微回调
    • 获取客户端配置
    • 获取RSA公钥
  1. 用户

搜索用户

正式环境
https://accounts.zwsoft.cn
正式环境
https://accounts.zwsoft.cn
GET
/api/v1.0/manage/users/search
最后修改时间:2023-11-01 09:22:06
需要role:Account.UserManager

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Query 参数
pageSize
integer 
可选
每页数量,1~1000,默认:50
示例值:
50
pageNum
integer 
可选
页码,由1起算,默认:1
示例值:
1
finder
string 
可选
手机\邮箱\用户名\姓名
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/manage/users/search?pageSize=50&pageNum=1&finder=' \
--header 'Authorization;'

返回响应

🟢200成功
application/json
Body
totalNum
integer 
总数量
必需
pageNum
integer 
当前页码
必需
pageSize
integer 
每页数量
必需
status
integer 
返回码
必需
详情请查看全局返回码
message
string 
错误详细信息
必需
无错误时,返回:success
error
string  | null 
错误代号
必需
详情请查看全局返回码
data
array[object (用户详细信息) {23}] 
返回数据
必需
无数据时为空列表
guid
string 
用户GUID
必需
userName
string 
用户名
必需
唯一,可用于索引用户
firstName
string  | null 
名字
必需
lastName
string  | null 
姓氏
必需
displayName
string 
显示名称
必需
profileImage
string 
头像链接
必需
已携带版本参数,若用户修改头像,则版本参数会自动变更
preferredLanguage
string 
偏好语言
必需
国际语言代号
itc
string  | null 
手机国别号
必需
phone
string  | null 
手机号
必需
仅当scope有phone时返回
email
string  | null 
邮箱
必需
仅当scope有email时返回
accountState
enum<string> 
账号状态
必需
枚举值:
NormalFreezeNotActive
securityStamp
string 
安全戳
必需
当安全戳改变时,表明用户进行了安全操作,需要重新登录
region
string  | null 
所属地区
必需
用户最常登录IP的国家或地区代码
isEmployee
boolean 
是否中望员工
必需
createTime
string 
注册时间
必需
lastLoginTime
string 
最后登录时间
必需
dateOfBirth
string  | null 
出生日期
必需
fromClient
string  | null 
用户来源
必需
客户端id
isPhoneReceiveInfo
boolean 
手机号是否接收资讯
必需
是否接收产品更新\推广\活动等信息
isEmailReceiveInfo
boolean 
邮箱是否接收资讯
必需
是否接收产品更新\推广\活动等信息
address
object 
联系地址
必需
jobInfo
object 
工作信息
必需
externalLoginInfos
array [object {3}] 
第三方登录信息
必需
未绑定第三方时为空列表
示例
{
    "status": 0,
    "message": "success",
    "error": null,
    "totalNum": 12,
    "pageSize": 50,
    "pageNum": 1,
    "data": [
        {
            "dateOfBirth": null,
            "address": {
                "street": null,
                "postalCode": null,
                "city": null,
                "provinceName": null,
                "countryName": null,
                "countryCode": null
            },
            "jobInfo": {
                "company": null,
                "industry": null,
                "department": null,
                "title": null
            },
            "isPhoneReceiveInfo": false,
            "isEmailReceiveInfo": false,
            "externalLoginInfos": [],
            "guid": "d8ee95c0-5ec2-4660-8380-0c515f70e1f6",
            "firstName": "0****@027168.com",
            "lastName": "-",
            "displayName": "0****@027168.com",
            "profileImage": "https://test.resources.zwsoft.cn/prd/ZwsoftAccounts/public/userHeadImg/tX7wO12rEKyO5Tv8HwlhAvk5WAJGQpdT8DjihKABQXd-7cbtH0F_w833m7mTO0iA/originalPic.png?v=1663124651",
            "preferredLanguage": "zh-CN",
            "userName": "KHB1XPYDXZ",
            "phone": null,
            "email": "0****@027168.com",
            "itc": null,
            "accountState": "Normal",
            "securityStamp": "a67a2c8d-521f-47da-b506-f3001a636dbe",
            "rememberLogin": false,
            "isEmployee": false,
            "createTime": "2022-09-14T03:04:10",
            "lastLoginTime": "2022-09-14T11:04:11.8722164+08:00"
        },
        {
            "dateOfBirth": null,
            "address": {
                "street": null,
                "postalCode": null,
                "city": null,
                "provinceName": null,
                "countryName": null,
                "countryCode": null
            },
            "jobInfo": {
                "company": null,
                "industry": null,
                "department": null,
                "title": null
            },
            "isPhoneReceiveInfo": false,
            "isEmailReceiveInfo": false,
            "externalLoginInfos": [],
            "guid": "0737d3f5-74d2-441c-b984-a9becc7bb0af",
            "firstName": "0****@027168.com",
            "lastName": "-",
            "displayName": "0****@027168.com",
            "profileImage": "https://test.resources.zwsoft.cn/prd/ZwsoftAccounts/public/userHeadImg/WTDrApv9Fm5OzzIlip--YD0FdZEHlDlrBOVI-j7C663NrTC7mm3zpUuRXAIUzT4F/originalPic.png?v=1663126058",
            "preferredLanguage": "zh-CN",
            "userName": "XpKh8yfcdE",
            "phone": null,
            "email": "0****@027168.com",
            "itc": null,
            "accountState": "Normal",
            "securityStamp": "ae430cec-f2bc-4197-95bd-22f34dbdfe45",
            "rememberLogin": false,
            "isEmployee": false,
            "createTime": "2022-09-14T03:27:37",
            "lastLoginTime": "2022-09-14T11:27:38.669185+08:00"
        },
        {
            "dateOfBirth": null,
            "address": {
                "street": null,
                "postalCode": null,
                "city": null,
                "provinceName": null,
                "countryName": null,
                "countryCode": null
            },
            "jobInfo": {
                "company": null,
                "industry": null,
                "department": null,
                "title": null
            },
            "isPhoneReceiveInfo": false,
            "isEmailReceiveInfo": false,
            "externalLoginInfos": [],
            "guid": "ddeced99-d8f2-4a8c-bc89-9cfb242da22b",
            "firstName": "0****@027168.com",
            "lastName": "-",
            "displayName": "0****@027168.com",
            "profileImage": "https://test.resources.zwsoft.cn/prd/ZwsoftAccounts/public/userHeadImg/umnxslHyotoOBkmfy3aHPxkN6TpTtD7GgrwksNu7tYDe_8ooyALceFdMDI5ff2Sb/originalPic.png?v=1663127473",
            "preferredLanguage": "zh-CN",
            "userName": "EozTvqPvqn",
            "phone": null,
            "email": "0****@027168.com",
            "itc": null,
            "accountState": "Normal",
            "securityStamp": "0496474f-25d9-49e4-a327-e85f50c42c81",
            "rememberLogin": false,
            "isEmployee": false,
            "createTime": "2022-09-14T03:51:12",
            "lastLoginTime": "2022-09-14T11:51:14.1300132+08:00"
        },
        {
            "dateOfBirth": null,
            "address": {
                "street": null,
                "postalCode": null,
                "city": null,
                "provinceName": null,
                "countryName": null,
                "countryCode": null
            },
            "jobInfo": {
                "company": null,
                "industry": null,
                "department": null,
                "title": null
            },
            "isPhoneReceiveInfo": false,
            "isEmailReceiveInfo": false,
            "externalLoginInfos": [],
            "guid": "70a0cff1-a356-4422-880c-6be7c3d70525",
            "firstName": "137****2360",
            "lastName": "-",
            "displayName": "137****2360",
            "profileImage": "https://test.resources.zwsoft.cn/prd/ZwsoftAccounts/public/userHeadImg/8ePi76DljZ_oT-t3gDeov5xBZmszmYkFBRMxeW8b4yOZpJ4AbE9lFzl9TmNyZsJD/originalPic.png?v=1663135526",
            "preferredLanguage": "zh-CN",
            "userName": "eEKBpLEaNB",
            "phone": "137****2360",
            "email": null,
            "itc": "+86",
            "accountState": "Normal",
            "securityStamp": "d6e7f4a2-2025-4403-84d8-853b5af8ab7b",
            "rememberLogin": false,
            "isEmployee": false,
            "createTime": "2022-09-14T06:05:24",
            "lastLoginTime": "2022-09-14T14:05:26.5818723+08:00"
        },
        {
            "dateOfBirth": null,
            "address": {
                "street": null,
                "postalCode": null,
                "city": null,
                "provinceName": null,
                "countryName": null,
                "countryCode": null
            },
            "jobInfo": {
                "company": null,
                "industry": null,
                "department": null,
                "title": null
            },
            "isPhoneReceiveInfo": false,
            "isEmailReceiveInfo": false,
            "externalLoginInfos": [],
            "guid": "b38c8a1f-ad33-46c8-9a80-e4c739e278e7",
            "firstName": "132****4463",
            "lastName": "-",
            "displayName": "132****4463",
            "profileImage": "https://test.resources.zwsoft.cn/prd/ZwsoftAccounts/public/userHeadImg/xQp4y_y8ux_N6P_EQ6FeRlPf58hohhD3ArG6F_lDtuTsgUJLFtdpWZ4pfIC3Uzpr/originalPic.png?v=1663223396",
            "preferredLanguage": "zh-CN",
            "userName": "TFVcNtZmpV",
            "phone": "132****4463",
            "email": null,
            "itc": "+86",
            "accountState": "Normal",
            "securityStamp": "4e98d007-8d7d-40ab-8b77-ac8aebb241f8",
            "rememberLogin": false,
            "isEmployee": false,
            "createTime": "2022-09-15T06:29:53",
            "lastLoginTime": "2022-09-15T14:29:58.5770238+08:00"
        },
        {
            "dateOfBirth": null,
            "address": {
                "street": null,
                "postalCode": null,
                "city": null,
                "provinceName": null,
                "countryName": null,
                "countryCode": null
            },
            "jobInfo": {
                "company": null,
                "industry": null,
                "department": null,
                "title": null
            },
            "isPhoneReceiveInfo": false,
            "isEmailReceiveInfo": false,
            "externalLoginInfos": [],
            "guid": "e2949f75-c903-4c0c-a18c-6f9ca86e77dd",
            "firstName": "182****5326",
            "lastName": "-",
            "displayName": "182****5326",
            "profileImage": "https://test.resources.zwsoft.cn/prd/ZwsoftAccounts/public/userHeadImg/pmDStTiUXiiVUHKfvNAidrofvRMrWCBbmpIgIt-qQWSbCCyNCszVQDcpKVcnex62/originalPic.png?v=1663223421",
            "preferredLanguage": "zh-CN",
            "userName": "XX0rUX08hq",
            "phone": "182****5326",
            "email": null,
            "itc": "+86",
            "accountState": "Normal",
            "securityStamp": "de26c50d-dbd7-44f7-bc56-e675025476a7",
            "rememberLogin": false,
            "isEmployee": false,
            "createTime": "2022-09-15T06:30:20",
            "lastLoginTime": "2022-09-15T14:30:21.9214856+08:00"
        },
        {
            "dateOfBirth": null,
            "address": {
                "street": null,
                "postalCode": null,
                "city": null,
                "provinceName": null,
                "countryName": null,
                "countryCode": null
            },
            "jobInfo": {
                "company": null,
                "industry": null,
                "department": null,
                "title": null
            },
            "isPhoneReceiveInfo": false,
            "isEmailReceiveInfo": false,
            "externalLoginInfos": [],
            "guid": "3da33ecf-95e3-4034-820e-5f93943948e4",
            "firstName": "177****1211",
            "lastName": "-",
            "displayName": "177****1211",
            "profileImage": "https://test.resources.zwsoft.cn/prd/ZwsoftAccounts/public/userHeadImg/mf1tVlz51jP9Gy_lsjUCb2LKtikCoJLZIJa342d0_wXWYvYZh-BW-r85ph0spaNd/originalPic.png?v=1663296661",
            "preferredLanguage": "zh-CN",
            "userName": "fINsZ3zqTy",
            "phone": "177****1211",
            "email": null,
            "itc": "+86",
            "accountState": "Normal",
            "securityStamp": "aba56e5f-4f02-4327-bff2-e0a02215a992",
            "rememberLogin": true,
            "isEmployee": false,
            "createTime": "2022-09-16T02:50:59",
            "lastLoginTime": "2022-10-09T14:51:43.7407532+08:00"
        },
        {
            "dateOfBirth": null,
            "address": {
                "street": null,
                "postalCode": null,
                "city": null,
                "provinceName": null,
                "countryName": null,
                "countryCode": null
            },
            "jobInfo": {
                "company": null,
                "industry": null,
                "department": null,
                "title": null
            },
            "isPhoneReceiveInfo": false,
            "isEmailReceiveInfo": false,
            "externalLoginInfos": [],
            "guid": "4fd84079-1c59-429f-8585-fda439aa5cfc",
            "firstName": "0****@027168.com",
            "lastName": "-",
            "displayName": "0****@027168.com",
            "profileImage": "https://test.resources.zwsoft.cn/prd/ZwsoftAccounts/public/userHeadImg/H5bsznMitEx8gMW4HEgvtpELvUxX9aGu-QPAy3Ks81Bogpl0uxGU9UfaBlyjKqWo/originalPic.png?v=1663826312",
            "preferredLanguage": "zh-CN",
            "userName": "3gs62ZSK9M",
            "phone": null,
            "email": "0****@027168.com",
            "itc": null,
            "accountState": "Normal",
            "securityStamp": "390ada69-ddcf-4526-81c9-d4357452f7bf",
            "rememberLogin": false,
            "isEmployee": false,
            "createTime": "2022-09-22T05:58:30",
            "lastLoginTime": "2022-09-22T13:58:32.4131507+08:00"
        },
        {
            "dateOfBirth": "2022-2-21",
            "address": {
                "street": "广州市天河区珠江西路15号",
                "postalCode": null,
                "city": null,
                "provinceName": null,
                "countryName": null,
                "countryCode": "US"
            },
            "jobInfo": {
                "company": "zhongwang",
                "industry": "普教",
                "department": "研发",
                "title": "测试"
            },
            "isPhoneReceiveInfo": false,
            "isEmailReceiveInfo": false,
            "externalLoginInfos": [],
            "guid": "ea7f3058-a94a-482e-a5b4-e542a993dbcc",
            "firstName": "波ppppp",
            "lastName": "离yyyy",
            "displayName": "离yyyy波ppppp",
            "profileImage": "https://test.resources.zwsoft.cn/prd/ZwsoftAccounts/public/userHeadImg/aMVQPrTLEXs4YLKA7A2hR3CFsak6TzldPIbv7TIETAccn08UB-24dOXcvfpDZSp_/originalPic.png",
            "preferredLanguage": "en-US",
            "userName": "ihwbze24370",
            "phone": null,
            "email": "i****@chacuo.net",
            "itc": null,
            "accountState": "Normal",
            "securityStamp": "9d892f2e-5e23-4f05-94b1-b3ef2e112eb5",
            "rememberLogin": false,
            "isEmployee": false,
            "createTime": "2021-10-15T02:12:10",
            "lastLoginTime": "2022-04-11T11:40:01.7573634+08:00"
        },
        {
            "dateOfBirth": null,
            "address": {
                "street": null,
                "postalCode": null,
                "city": null,
                "provinceName": null,
                "countryName": null,
                "countryCode": null
            },
            "jobInfo": {
                "company": null,
                "industry": null,
                "department": null,
                "title": null
            },
            "isPhoneReceiveInfo": false,
            "isEmailReceiveInfo": false,
            "externalLoginInfos": [],
            "guid": "6d497d84-7886-435d-aec2-6e662e4995de",
            "firstName": "-",
            "lastName": "-",
            "displayName": "- -",
            "profileImage": "https://test.resources.zwsoft.cn/prd/ZwsoftAccounts/public/userHeadImg/7sFCXfIbfFszZr_VC3xNaZOchh2luhugKOgfiCvxJycUgDS2M-tzfPhKKtexMZtI/originalPic.png",
            "preferredLanguage": "zh-CN",
            "userName": "kosbgt78523",
            "phone": null,
            "email": "k****@chacuo.net",
            "itc": null,
            "accountState": "Normal",
            "securityStamp": "279b7958-d5cb-4493-8848-b63137c436a0",
            "rememberLogin": false,
            "isEmployee": false,
            "createTime": "2021-09-18T11:01:34",
            "lastLoginTime": "2021-11-03T14:51:11.0317514+08:00"
        },
        {
            "dateOfBirth": "2022-1-14",
            "address": {
                "street": "珠江新城",
                "postalCode": "510623",
                "city": null,
                "provinceName": null,
                "countryName": "China",
                "countryCode": "CN"
            },
            "jobInfo": {
                "company": "啊啊啊25",
                "industry": "计算机软件",
                "department": "研发中台",
                "title": "软件测试工程师"
            },
            "isPhoneReceiveInfo": true,
            "isEmailReceiveInfo": true,
            "externalLoginInfos": [],
            "guid": "2574e894-3794-4f9b-916b-22d4022f3d83",
            "firstName": "曾伊丽",
            "lastName": "-",
            "displayName": "曾伊丽",
            "profileImage": "https://test.resources.zwsoft.cn/prd/ZwsoftAccounts/public/userHeadImg/CRtnxB3uGBBSbc-6s4-fP_zeeXaY4f8pET1KgDegFE3ybeBNxzoPamR4beQ6LgV8/originalPic.png",
            "preferredLanguage": "zh-CN",
            "userName": "zengyili",
            "phone": "187****8598",
            "email": "z****@zwcad.com",
            "itc": "+86",
            "accountState": "Normal",
            "securityStamp": "bc004410-9a52-4ae1-bf54-96e0366f2872",
            "rememberLogin": false,
            "isEmployee": false,
            "createTime": "2021-10-20T06:55:25",
            "lastLoginTime": "2022-10-14T14:25:08.5448781+08:00"
        },
        {
            "dateOfBirth": null,
            "address": {
                "street": null,
                "postalCode": null,
                "city": null,
                "provinceName": null,
                "countryName": null,
                "countryCode": null
            },
            "jobInfo": {
                "company": null,
                "industry": null,
                "department": null,
                "title": null
            },
            "isPhoneReceiveInfo": false,
            "isEmailReceiveInfo": false,
            "externalLoginInfos": [],
            "guid": "19753e79-7666-4921-b96f-6e0375a6038e",
            "firstName": "-",
            "lastName": "-",
            "displayName": "g****@chacuo.net",
            "profileImage": "https://test.resources.zwsoft.cn/prd/ZwsoftAccounts/public/userHeadImg/hjnP9TLHOXkMPRatgItrD6ZILbjd_QCl-149rMmQ_tILfgMYXHy3lIBZ5gbAUlc3/originalPic.png",
            "preferredLanguage": "zh-CN",
            "userName": "gyewzb35921",
            "phone": null,
            "email": "g****@chacuo.net",
            "itc": null,
            "accountState": "Normal",
            "securityStamp": "4572fc10-bf3e-4e77-863a-bd4f5f5f9006",
            "rememberLogin": false,
            "isEmployee": false,
            "createTime": "2021-09-18T10:19:58",
            "lastLoginTime": "2022-01-06T17:53:13.8037215+08:00"
        }
    ]
}
修改于 2023-11-01 09:22:06
上一页
获取数据下载记录
下一页
获取用户部门名称链
Built with