中望帐号
  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. 用户

批量修改用户详细信息

测试中
正式环境
https://accounts.zwsoft.cn
正式环境
https://accounts.zwsoft.cn
POST
/api/v1.0/trusted/users/details
公开
最后修改时间:2025-03-10 06:59:11
需要scope:ZMS.Users.Write
请求体中不需要修改的字段可省略或null。
单次修改不超过500个用户

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Header 参数
Authorization
string 
必需
Body 参数application/json
array of:
guid
string 
用户guid
必需
firstName
string  | null 
名字
可选
lastName
string  | null 
姓氏
可选
displayName
string  | null 
显示名称
可选
preferredLanguage
string  | null 
偏好语言
可选
国际语言代号
dateOfBirth
string  | null 
出生日期
可选
address
object 
联系地址
可选
street
string  | null 
街道
可选
postalCode
string  | null 
邮政编码
可选
city
string  | null 
城市
可选
provinceName
string  | null 
省份
可选
countryName
string  | null 
国家地区名
可选
countryCode
string  | null 
国家地区代号
可选
国际标准代号
jobInfo
object 
工作信息
可选
company
string  | null 
公司名称
可选
industry
string  | null 
行业
可选
department
string  | null 
部门
可选
title
string  | null 
职位
可选
isPhoneReceiveInfo
boolean  | null 
手机号是否接收营销通知
可选
isEmailReceiveInfo
string  | null 
邮箱是否接收营销通知
可选
示例
[
    {
        "guid": "39890479-f96d-46e7-8bde-93bb4945a31a",
        "dateOfBirth": "1997-01-01",
        "address": {
            "street": "珠江西路15号",
            "postalCode": "510623",
            "countryCode": "CN"
        },
        "jobInfo": {
            "company": "广州中望龙腾软件股份有限公司",
            "industry": "计算机软件",
            "department": "研发中台",
            "title": "测试工程师"
        },
        "isEmailReceiveInfo": true
    },
    {
        "guid": "2eb0e44e-28f4-488d-8f03-a191b9fb03fb",
        "displayName": "JLLLL"
    }
]

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://accounts.zwsoft.cn/api/v1.0/trusted/users/details' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "guid": "39890479-f96d-46e7-8bde-93bb4945a31a",
        "dateOfBirth": "1997-01-01",
        "address": {
            "street": "珠江西路15号",
            "postalCode": "510623",
            "countryCode": "CN"
        },
        "jobInfo": {
            "company": "广州中望龙腾软件股份有限公司",
            "industry": "计算机软件",
            "department": "研发中台",
            "title": "测试工程师"
        },
        "isEmailReceiveInfo": true
    },
    {
        "guid": "2eb0e44e-28f4-488d-8f03-a191b9fb03fb",
        "displayName": "JLLLL"
    }
]'

返回响应

🟢200成功
application/json
Body
status
integer 
返回码
必需
详情请查看全局返回码
message
string 
错误详细信息
必需
无错误时,返回:success
error
string  | null 
错误代号
必需
详情请查看全局返回码
data
array [object {2}] 
返回数据
必需
无数据时为空列表
error
object  | null 
错误信息
必需
userInfo
object (用户详细信息) 
必需
示例
{
    "status": 0,
    "message": "success",
    "error": null,
    "data": [
        {
            "error": null,
            "userInfo": {
                "dateOfBirth": "2008-01-01",
                "address": {
                    "street": "珠江西路12345号",
                    "postalCode": "510623",
                    "city": null,
                    "provinceName": null,
                    "countryName": null,
                    "countryCode": "CN"
                },
                "jobInfo": {
                    "company": "zw",
                    "industry": "车辆与交通运输",
                    "department": "测试11下/腾讯公司/超级无敌长的部门名1/超级无敌长的部门名2/超级无敌长的部门名3/超级无敌长的部门名4/超级无敌长的部门名",
                    "title": "测试工程师6"
                },
                "isPhoneReceiveInfo": false,
                "isEmailReceiveInfo": false,
                "fromClient": "CP",
                "externalLoginInfos": [
                    {
                        "provider": "Huawei",
                        "displayName": "hid32648117",
                        "externalID": "MDHHfZjk8h90SVD3t8eH9qmPJTZvMTn50hzHhQeSkRxpvA"
                    }
                ],
                "guid": "39890479-f96d-46e7-8bde-93bb4945a31a",
                "firstName": "嘉良",
                "lastName": "Li",
                "displayName": "嘉良 Li",
                "profileImage": "https://test.resources.zwsoft.cn/prd/ZwsoftAccounts/public/userHeadImg/UtrXIbFfU-shYijOGiAEKqwzFiBnKLEPLKAsdFVd48kVCgVnpoIrRvTVxAyTRzJ5/originalPic.png?v=1720508437",
                "preferredLanguage": "zh-CN",
                "userName": "LIJIALIANG1",
                "phone": null,
                "email": null,
                "itc": null,
                "accountState": "Normal",
                "securityStamp": "9aa256c2-afb2-43ee-b429-26298ec4a4e1",
                "rememberLogin": false,
                "isEmployee": false,
                "createTime": "2022-06-07T09:04:18.000Z",
                "lastLoginTime": "2025-03-10T02:04:56.711Z",
                "region": "CN"
            }
        },
        {
            "error": null,
            "userInfo": {
                "dateOfBirth": "2004-5-9",
                "address": {
                    "street": "珠江西路20号",
                    "postalCode": null,
                    "city": null,
                    "provinceName": null,
                    "countryName": "中国",
                    "countryCode": null
                },
                "jobInfo": {
                    "company": "zw",
                    "industry": "高科技与生活",
                    "department": "中台bbb",
                    "title": null
                },
                "isPhoneReceiveInfo": false,
                "isEmailReceiveInfo": false,
                "fromClient": "accounts",
                "externalLoginInfos": [
                    {
                        "provider": "WeChat",
                        "displayName": "李嘉良",
                        "externalID": "oMo86tzj2SjizZzK4-_6-J6GTok4"
                    }
                ],
                "guid": "2eb0e44e-28f4-488d-8f03-a191b9fb03fb",
                "firstName": "-",
                "lastName": "-",
                "displayName": "JLLLL",
                "profileImage": "https://test.resources.zwsoft.cn/prd/ZwsoftAccounts/public/userHeadImg/WNHLoiGhNL3hXvIgJ-Wff5NGUrWMHejhwxSV65lZRQOq_0-VqajXR40EiwKkq_rC/originalPic.png?v=1678847665",
                "preferredLanguage": "zh-CN",
                "userName": "WUZ90R6SXK",
                "phone": null,
                "email": null,
                "itc": null,
                "accountState": "Normal",
                "securityStamp": "5fd7f48f-317b-40d8-80f1-dd350296419c",
                "rememberLogin": false,
                "isEmployee": false,
                "createTime": "2022-06-20T10:03:41.000Z",
                "lastLoginTime": "2025-03-10T06:47:25.429Z",
                "region": "CN"
            }
        }
    ]
}
修改于 2025-03-10 06:59:11
上一页
增加用户第三方绑定信息
下一页
刷新企业用户部门
Built with