操作文档
2025-11-15
目录

用户

# 概述

用户API 用户用于登录以及权限认证，权限基本都以用户为单位每个用户都存在不同的资源权限 该API提供了用户本体的CRUD以及修改密码与用户相关的查询等功能

类名

UserApi.java

成员方法

名称 方法 Method Path
新增用户 addUser POST /api-organization/user/addUser
删除用户 deleteUser POST /api-organization/user/deleteUser
获取企业下所有用户 getCompanyAllUser POST /api-organization/user/getCompanyAllUser
获取部门里拥有项目的用户列表 getHasProjectUserListByDeptId POST /api-organization/user/getHasProjectUserListByDeptId
获取当前登录用户详细信息 getLoginUser POST /api-organization/user/getLoginUser
获取用户信息集合 getUserInfoList POST /api-organization/user/getUserInfoList
判断用户是否是企业客户的运维人员 getUserInfoMaintenance POST /api-organization/user/getUserInfoMaintenance
获取指定部门下的用户列表 getUserListByDeptId POST /api-organization/user/getUserListByDeptId
查询用户定位列表 getUserLocationList POST /api-organization/user/getUserLocationList
设置当前用户设置的语言状态 getUserSetLanguageState POST /api-organization/user/getUserSetLanguageState
获取当前用户的时区 getUserSetZoneConfig POST /api-organization/user/getUserSetZoneConfig
查询用户账号密码是否是弱密码 inspectWeakUsernameAndPassword POST /api-organization/user/inspectWeakUsernameAndPassword
新增或修改用户定位 saveUserLocation POST /api-organization/user/saveUserLocation
设置当前用户设置的语言状态 setUserSetLanguageState POST /api-organization/user/setUserSetLanguageState
设置当前用户的时区 setUserSetZoneConfig POST /api-organization/user/setUserSetZoneConfig
修改邮箱 updateEmail POST /api-organization/user/updateEmail
修改密码 updatePassword POST /api-organization/user/updatePassword
修改当前用户手机号 updatePhone POST /api-organization/user/updatePhone
修改当前用户基本信息 updateUserBaseInfo POST /api-organization/user/updateUserBaseInfo
修改用户全部信息 updateUserInfo POST /api-organization/user/updateUserInfo

# 新增用户

ResultObject addUser(userForm)

新增用户

# 请求参数

名称 类型 描述 备注
userForm UserForm userForm

# UserForm

名称 类型 描述 备注
address String 地址 -
departmentId String 部门ID
deviceId String 图片验证码设备id -
email String 电子邮箱 -
focusOnAll Boolean 是否关注全部项目 只能是企业管理员是才可关注全部项目，true：是 false：否 -
lock Boolean 账号是否锁定(1:锁定 0未锁定) -
needEncrypt Boolean 密码、手机号、办公电话、邮箱是否加密 -
nickname String 昵称 -
officePhone String 办公电话 -
password String 密码
phone String 手机号 -
phoneCode String 手机验证码 -
remark String 备注 -
roleId String 角色ID
sex Integer 性别(0:男 1:女 2:未知) -
source Integer 数据来源(0注册审核,1企业管理菜单中手动添加,2超级用户添加企业时生成,3系统自动添加)
type Integer 类型(1管理员 2普通用户)与实际的type不一样 -
username String 用户名

# 返回参数

ResultObject

名称 类型 描述 备注
code String 响应码 -
data Object 响应数据 -
msg String 响应消息 -
time OffsetDateTime 响应时间 -

# java-sdk 调用示例

//实例化api类，传入token
UserApi apiInstance = new UserApi(token);
//实例化请求参数
UserForm userForm = new UserForm();

try {
    ResultObject result = apiInstance.addUser(userForm);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("调用UserApi.addUser异常: " + e.getMessage());
    e.printStackTrace();
}
1
2
3
4
5
6
7
8
9
10
11
12

# HTTP 调用示例

属性 名称
HTTP请求地址 http://[server]:[port]/api-organization/user/addUser
请求方式 POST
Content-Type application/json
header:key Authorization
header:value Bearer YOUR_ACCESS_TOKEN

请求参数：

{
	"address":"",
	"roleId":"",
	"departmentId":"",
	"sex":0,
	"remark":"",
	"source":0,
	"focusOnAll":false,
	"type":0,
	"deviceId":"",
	"needEncrypt":false,
	"password":"",
	"officePhone":"",
	"phone":"",
	"nickname":"",
	"lock":false,
	"phoneCode":"",
	"email":"",
	"username":""
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

# 删除用户

ResultObject deleteUser(userId)

根据id删除用户

# 请求参数

名称 类型 描述 备注
userId String 用户ID

# 返回参数

ResultObject

名称 类型 描述 备注
code String 响应码 -
data Object 响应数据 -
msg String 响应消息 -
time OffsetDateTime 响应时间 -

# java-sdk 调用示例

//实例化api类，传入token
UserApi apiInstance = new UserApi(token);
//实例化请求参数
String userId = "userId_example";

try {
    ResultObject result = apiInstance.deleteUser(userId);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("调用UserApi.deleteUser异常: " + e.getMessage());
    e.printStackTrace();
}
1
2
3
4
5
6
7
8
9
10
11
12

# HTTP 调用示例

属性 名称
HTTP请求地址 http://[server]:[port]/api-organization/user/deleteUser
请求方式 POST
Content-Type application/json
header:key Authorization
header:value Bearer YOUR_ACCESS_TOKEN

请求参数：

{
	"userId":""
}
1
2
3

# 获取企业下所有用户

ResultListUserVo getCompanyAllUser(needEncrypt)

获取企业下所有用户

# 请求参数

名称 类型 描述 备注
needEncrypt Boolean 是否加密 -

# 返回参数

ResultListUserVo

名称 类型 描述 备注
code String 响应码 -
data List<UserVo> 响应数据 -
msg String 响应消息 -
time OffsetDateTime 响应时间 -

UserVo

名称 类型 描述 备注
address String 地址 -
avatar String 头像地址 -
companyId String 企业id -
createdBy String 创建人 -
createdTime OffsetDateTime 创建时间 -
createdTimeTimestamp Long 创建时间-时间戳 -
departmentId String 部门标识 -
departmentName String 部门名称 -
email String 邮箱 -
enabled Boolean 是否启用:1是0否 -
id String 主键id -
nickname String 昵称 -
officePhone String 办公号码 -
phone String 手机号 -
remark String 备注 -
roleId String 角色id -
roleName String 角色name -
sex Integer 性别 0.男,1女,2未知 -
sid String 二次开发访问密钥 -
type Integer 类型 0超级管理员(super),1超级企业管理员2企业管理员,3企业用户,4部门管理员5部门用户 -
updatedTime OffsetDateTime 修改时间 -
updatedTimeTimestamp Long 修改时间-时间戳 -
username String 用户名 -

# java-sdk 调用示例

//实例化api类，传入token
UserApi apiInstance = new UserApi(token);
//实例化请求参数
Boolean needEncrypt = true;

try {
    ResultListUserVo result = apiInstance.getCompanyAllUser(needEncrypt);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("调用UserApi.getCompanyAllUser异常: " + e.getMessage());
    e.printStackTrace();
}
1
2
3
4
5
6
7
8
9
10
11
12

# HTTP 调用示例

属性 名称
HTTP请求地址 http://[server]:[port]/api-organization/user/getCompanyAllUser
请求方式 POST
Content-Type application/json
header:key Authorization
header:value Bearer YOUR_ACCESS_TOKEN

请求参数：

{}
1

# 获取部门里拥有项目的用户列表

ResultListUserVo getHasProjectUserListByDeptId(deptId, projectId, needEncrypt)

获取部门里拥有项目的用户列表

# 请求参数

名称 类型 描述 备注
deptId String 部门ID
projectId String 项目ID
needEncrypt Boolean 是否加密 -

# 返回参数

ResultListUserVo

名称 类型 描述 备注
code String 响应码 -
data List<UserVo> 响应数据 -
msg String 响应消息 -
time OffsetDateTime 响应时间 -

UserVo

名称 类型 描述 备注
address String 地址 -
avatar String 头像地址 -
companyId String 企业id -
createdBy String 创建人 -
createdTime OffsetDateTime 创建时间 -
createdTimeTimestamp Long 创建时间-时间戳 -
departmentId String 部门标识 -
departmentName String 部门名称 -
email String 邮箱 -
enabled Boolean 是否启用:1是0否 -
id String 主键id -
nickname String 昵称 -
officePhone String 办公号码 -
phone String 手机号 -
remark String 备注 -
roleId String 角色id -
roleName String 角色name -
sex Integer 性别 0.男,1女,2未知 -
sid String 二次开发访问密钥 -
type Integer 类型 0超级管理员(super),1超级企业管理员2企业管理员,3企业用户,4部门管理员5部门用户 -
updatedTime OffsetDateTime 修改时间 -
updatedTimeTimestamp Long 修改时间-时间戳 -
username String 用户名 -

# java-sdk 调用示例

//实例化api类，传入token
UserApi apiInstance = new UserApi(token);
//实例化请求参数
String deptId = "deptId_example";
String projectId = "projectId_example";
Boolean needEncrypt = true;

try {
    ResultListUserVo result = apiInstance.getHasProjectUserListByDeptId(deptId, projectId, needEncrypt);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("调用UserApi.getHasProjectUserListByDeptId异常: " + e.getMessage());
    e.printStackTrace();
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14

# HTTP 调用示例

属性 名称
HTTP请求地址 http://[server]:[port]/api-organization/user/getHasProjectUserListByDeptId
请求方式 POST
Content-Type application/json
header:key Authorization
header:value Bearer YOUR_ACCESS_TOKEN

请求参数：

{
	"deptId":"",
	"projectId":""
}
1
2
3
4

# 获取当前登录用户详细信息

ResultLoginUserVo getLoginUser(needEncrypt)

获取当前登录用户详细信息

# 请求参数

名称 类型 描述 备注
needEncrypt Boolean 是否加密 -

# 返回参数

ResultLoginUserVo

名称 类型 描述 备注
code String 响应码 -
data LoginUserVo 响应数据 -
msg String 响应消息 -
time OffsetDateTime 响应时间 -

LoginUserVo

名称 类型 描述 备注
applicationCenter List<RouteVo> 应用中心路由 -
avatar String 头像地址 -
companyId String 企业id -
departmentId String 部门id -
email String 邮箱 -
id String 用户id -
nickname String 昵称 -
permissionCodes List<String> 资源 -
phone String 手机号码 -
routeMenu List<RouteVo> 路由菜单 -
type Integer 类型(0超级管理员(super),1超级企业管理员2企业管理员,3企业用户,4部门管理员5部门用户,6个人开发者) -
userDefaultLanguage String 用户语言类型 -
userZone String 用户时区（为空时请自行从终端获取） -
username String 用户名 -

RouteVo

名称 类型 描述 备注
children List<RouteVo> -
component String -
description String -
id String -
isClientRoute Integer -
isWebHide Integer -
meta MetaVo -
name String -
path String -
redirect String -
type Integer -

RouteVo

名称 类型 描述 备注
children List<RouteVo> -
component String -
description String -
id String -
isClientRoute Integer -
isWebHide Integer -
meta MetaVo -
name String -
path String -
redirect String -
type Integer -

# java-sdk 调用示例

//实例化api类，传入token
UserApi apiInstance = new UserApi(token);
//实例化请求参数
Boolean needEncrypt = true;

try {
    ResultLoginUserVo result = apiInstance.getLoginUser(needEncrypt);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("调用UserApi.getLoginUser异常: " + e.getMessage());
    e.printStackTrace();
}
1
2
3
4
5
6
7
8
9
10
11
12

# HTTP 调用示例

属性 名称
HTTP请求地址 http://[server]:[port]/api-organization/user/getLoginUser
请求方式 POST
Content-Type application/json
header:key Authorization
header:value Bearer YOUR_ACCESS_TOKEN

请求参数：

{}
1

# 获取用户信息集合

ResultListUserVo getUserInfoList(userIds, needEncrypt)

根据id集合获取用户信息集合

# 请求参数

名称 类型 描述 备注
userIds List<String> 用户ID集合
needEncrypt Boolean 是否加密 -

# 返回参数

ResultListUserVo

名称 类型 描述 备注
code String 响应码 -
data List<UserVo> 响应数据 -
msg String 响应消息 -
time OffsetDateTime 响应时间 -

UserVo

名称 类型 描述 备注
address String 地址 -
avatar String 头像地址 -
companyId String 企业id -
createdBy String 创建人 -
createdTime OffsetDateTime 创建时间 -
createdTimeTimestamp Long 创建时间-时间戳 -
departmentId String 部门标识 -
departmentName String 部门名称 -
email String 邮箱 -
enabled Boolean 是否启用:1是0否 -
id String 主键id -
nickname String 昵称 -
officePhone String 办公号码 -
phone String 手机号 -
remark String 备注 -
roleId String 角色id -
roleName String 角色name -
sex Integer 性别 0.男,1女,2未知 -
sid String 二次开发访问密钥 -
type Integer 类型 0超级管理员(super),1超级企业管理员2企业管理员,3企业用户,4部门管理员5部门用户 -
updatedTime OffsetDateTime 修改时间 -
updatedTimeTimestamp Long 修改时间-时间戳 -
username String 用户名 -

# java-sdk 调用示例

//实例化api类，传入token
UserApi apiInstance = new UserApi(token);
//实例化请求参数
List<String> userIds = Arrays.asList(new List<String>());
Boolean needEncrypt = true;

try {
    ResultListUserVo result = apiInstance.getUserInfoList(userIds, needEncrypt);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("调用UserApi.getUserInfoList异常: " + e.getMessage());
    e.printStackTrace();
}
1
2
3
4
5
6
7
8
9
10
11
12
13

# HTTP 调用示例

属性 名称
HTTP请求地址 http://[server]:[port]/api-organization/user/getUserInfoList
请求方式 POST
Content-Type application/json
header:key Authorization
header:value Bearer YOUR_ACCESS_TOKEN

请求参数：

{
	"userIds":[]
}
1
2
3

# 判断用户是否是企业客户的运维人员

ResultListCompanyMaintenance getUserInfoMaintenance(userId)

判断用户是否是企业客户的运维人员

# 请求参数

名称 类型 描述 备注
userId String 用户ID

# 返回参数

ResultListCompanyMaintenance

名称 类型 描述 备注
code String 响应码 -
data List<CompanyMaintenance> 响应数据 -
msg String 响应消息 -
time OffsetDateTime 响应时间 -

CompanyMaintenance

名称 类型 描述 备注
accreditCompanyId String 授权企业ID -
clientId String 被授权企业ID -
createdTime OffsetDateTime 创建时间 -
id String ID -
maintenanceId String 维保ID (部门ID、用户ID) -
projectId String 类型 0:部门ID、1:用户ID -
type Integer 类型 0:部门ID、1:用户ID -
updatedTime OffsetDateTime 修改时间 -

# java-sdk 调用示例

//实例化api类，传入token
UserApi apiInstance = new UserApi(token);
//实例化请求参数
String userId = "userId_example";

try {
    ResultListCompanyMaintenance result = apiInstance.getUserInfoMaintenance(userId);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("调用UserApi.getUserInfoMaintenance异常: " + e.getMessage());
    e.printStackTrace();
}
1
2
3
4
5
6
7
8
9
10
11
12

# HTTP 调用示例

属性 名称
HTTP请求地址 http://[server]:[port]/api-organization/user/getUserInfoMaintenance
请求方式 POST
Content-Type application/json
header:key Authorization
header:value Bearer YOUR_ACCESS_TOKEN

请求参数：

{
	"userId":""
}
1
2
3

# 获取指定部门下的用户列表

ResultListUserVo getUserListByDeptId(deptId, needEncrypt)

获取当前登录用户的企业,再查询指定部门下的用户集合

# 请求参数

名称 类型 描述 备注
deptId String 部门ID
needEncrypt Boolean 是否加密 -

# 返回参数

ResultListUserVo

名称 类型 描述 备注
code String 响应码 -
data List<UserVo> 响应数据 -
msg String 响应消息 -
time OffsetDateTime 响应时间 -

UserVo

名称 类型 描述 备注
address String 地址 -
avatar String 头像地址 -
companyId String 企业id -
createdBy String 创建人 -
createdTime OffsetDateTime 创建时间 -
createdTimeTimestamp Long 创建时间-时间戳 -
departmentId String 部门标识 -
departmentName String 部门名称 -
email String 邮箱 -
enabled Boolean 是否启用:1是0否 -
id String 主键id -
nickname String 昵称 -
officePhone String 办公号码 -
phone String 手机号 -
remark String 备注 -
roleId String 角色id -
roleName String 角色name -
sex Integer 性别 0.男,1女,2未知 -
sid String 二次开发访问密钥 -
type Integer 类型 0超级管理员(super),1超级企业管理员2企业管理员,3企业用户,4部门管理员5部门用户 -
updatedTime OffsetDateTime 修改时间 -
updatedTimeTimestamp Long 修改时间-时间戳 -
username String 用户名 -

# java-sdk 调用示例

//实例化api类，传入token
UserApi apiInstance = new UserApi(token);
//实例化请求参数
String deptId = "deptId_example";
Boolean needEncrypt = true;

try {
    ResultListUserVo result = apiInstance.getUserListByDeptId(deptId, needEncrypt);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("调用UserApi.getUserListByDeptId异常: " + e.getMessage());
    e.printStackTrace();
}
1
2
3
4
5
6
7
8
9
10
11
12
13

# HTTP 调用示例

属性 名称
HTTP请求地址 http://[server]:[port]/api-organization/user/getUserListByDeptId
请求方式 POST
Content-Type application/json
header:key Authorization
header:value Bearer YOUR_ACCESS_TOKEN

请求参数：

{
	"deptId":""
}
1
2
3

# 查询用户定位列表

ResultListUserLocationVo getUserLocationList()

只查询当前企业下的用户定位列表

# 请求参数

请求参数为空.

# 返回参数

ResultListUserLocationVo

名称 类型 描述 备注
code String 响应码 -
data List<UserLocationVo> 响应数据 -
msg String 响应消息 -
time OffsetDateTime 响应时间 -

UserLocationVo

名称 类型 描述 备注
id String 用户id -
lat String 纬度 -
lon String 经度 -
phone String 手机号 -
status String 0 在线，1 离线 -
userName String 用户名称 -

# java-sdk 调用示例

//实例化api类，传入token
UserApi apiInstance = new UserApi(token);

try {
    ResultListUserLocationVo result = apiInstance.getUserLocationList();
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("调用UserApi.getUserLocationList异常: " + e.getMessage());
    e.printStackTrace();
}
1
2
3
4
5
6
7
8
9
10

# HTTP 调用示例

属性 名称
HTTP请求地址 http://[server]:[port]/api-organization/user/getUserLocationList
请求方式 POST
Content-Type application/json
header:key Authorization
header:value Bearer YOUR_ACCESS_TOKEN

请求参数：

{}
1

# 设置当前用户设置的语言状态

ResultObject getUserSetLanguageState()

设置当前用户设置的语言状态

# 请求参数

请求参数为空.

# 返回参数

ResultObject

名称 类型 描述 备注
code String 响应码 -
data Object 响应数据 -
msg String 响应消息 -
time OffsetDateTime 响应时间 -

# java-sdk 调用示例

//实例化api类，传入token
UserApi apiInstance = new UserApi(token);

try {
    ResultObject result = apiInstance.getUserSetLanguageState();
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("调用UserApi.getUserSetLanguageState异常: " + e.getMessage());
    e.printStackTrace();
}
1
2
3
4
5
6
7
8
9
10

# HTTP 调用示例

属性 名称
HTTP请求地址 http://[server]:[port]/api-organization/user/getUserSetLanguageState
请求方式 POST
Content-Type application/json
header:key Authorization
header:value Bearer YOUR_ACCESS_TOKEN

请求参数：

{}
1

# 获取当前用户的时区

ResultObject getUserSetZoneConfig()

获取当前用户的时区

# 请求参数

请求参数为空.

# 返回参数

ResultObject

名称 类型 描述 备注
code String 响应码 -
data Object 响应数据 -
msg String 响应消息 -
time OffsetDateTime 响应时间 -

# java-sdk 调用示例

//实例化api类，传入token
UserApi apiInstance = new UserApi(token);

try {
    ResultObject result = apiInstance.getUserSetZoneConfig();
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("调用UserApi.getUserSetZoneConfig异常: " + e.getMessage());
    e.printStackTrace();
}
1
2
3
4
5
6
7
8
9
10

# HTTP 调用示例

属性 名称
HTTP请求地址 http://[server]:[port]/api-organization/user/getUserSetZoneConfig
请求方式 POST
Content-Type application/json
header:key Authorization
header:value Bearer YOUR_ACCESS_TOKEN

请求参数：

{}
1

# 查询用户账号密码是否是弱密码

ResultObject inspectWeakUsernameAndPassword(password, username)

查询用户账号密码是否是弱密码

# 请求参数

名称 类型 描述 备注
password String 用户密码 -
username String 用户账号 -

# 返回参数

ResultObject

名称 类型 描述 备注
code String 响应码 -
data Object 响应数据 -
msg String 响应消息 -
time OffsetDateTime 响应时间 -

# java-sdk 调用示例

//实例化api类，传入token
UserApi apiInstance = new UserApi(token);
//实例化请求参数
String password = "password_example";
String username = "username_example";

try {
    ResultObject result = apiInstance.inspectWeakUsernameAndPassword(password, username);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("调用UserApi.inspectWeakUsernameAndPassword异常: " + e.getMessage());
    e.printStackTrace();
}
1
2
3
4
5
6
7
8
9
10
11
12
13

# HTTP 调用示例

属性 名称
HTTP请求地址 http://[server]:[port]/api-organization/user/inspectWeakUsernameAndPassword
请求方式 POST
Content-Type application/json
header:key Authorization
header:value Bearer YOUR_ACCESS_TOKEN

请求参数：

{
	"password":"",
	"username":""
}
1
2
3
4

# 新增或修改用户定位

ResultObject saveUserLocation(lat, lon, userId)

存在即修改不存在则新增

# 请求参数

名称 类型 描述 备注
lat String 纬度
lon String 经度
userId String 用户ID -

# 返回参数

ResultObject

名称 类型 描述 备注
code String 响应码 -
data Object 响应数据 -
msg String 响应消息 -
time OffsetDateTime 响应时间 -

# java-sdk 调用示例

//实例化api类，传入token
UserApi apiInstance = new UserApi(token);
//实例化请求参数
String lat = "lat_example";
String lon = "lon_example";
String userId = "userId_example";

try {
    ResultObject result = apiInstance.saveUserLocation(lat, lon, userId);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("调用UserApi.saveUserLocation异常: " + e.getMessage());
    e.printStackTrace();
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14

# HTTP 调用示例

属性 名称
HTTP请求地址 http://[server]:[port]/api-organization/user/saveUserLocation
请求方式 POST
Content-Type application/json
header:key Authorization
header:value Bearer YOUR_ACCESS_TOKEN

请求参数：

{
	"lat":"",
	"lon":"",
	"userId":""
}
1
2
3
4
5

# 设置当前用户设置的语言状态

ResultObject setUserSetLanguageState(lang)

设置当前用户设置的语言状态

# 请求参数

名称 类型 描述 备注
lang String 语言类型 -

# 返回参数

ResultObject

名称 类型 描述 备注
code String 响应码 -
data Object 响应数据 -
msg String 响应消息 -
time OffsetDateTime 响应时间 -

# java-sdk 调用示例

//实例化api类，传入token
UserApi apiInstance = new UserApi(token);
//实例化请求参数
String lang = "lang_example";

try {
    ResultObject result = apiInstance.setUserSetLanguageState(lang);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("调用UserApi.setUserSetLanguageState异常: " + e.getMessage());
    e.printStackTrace();
}
1
2
3
4
5
6
7
8
9
10
11
12

# HTTP 调用示例

属性 名称
HTTP请求地址 http://[server]:[port]/api-organization/user/setUserSetLanguageState
请求方式 POST
Content-Type application/json
header:key Authorization
header:value Bearer YOUR_ACCESS_TOKEN

请求参数：

{
	"lang":""
}
1
2
3

# 设置当前用户的时区

ResultObject setUserSetZoneConfig(zone)

设置当前用户的时区

# 请求参数

名称 类型 描述 备注
zone String 时区-编号 -

# 返回参数

ResultObject

名称 类型 描述 备注
code String 响应码 -
data Object 响应数据 -
msg String 响应消息 -
time OffsetDateTime 响应时间 -

# java-sdk 调用示例

//实例化api类，传入token
UserApi apiInstance = new UserApi(token);
//实例化请求参数
String zone = "zone_example";

try {
    ResultObject result = apiInstance.setUserSetZoneConfig(zone);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("调用UserApi.setUserSetZoneConfig异常: " + e.getMessage());
    e.printStackTrace();
}
1
2
3
4
5
6
7
8
9
10
11
12

# HTTP 调用示例

属性 名称
HTTP请求地址 http://[server]:[port]/api-organization/user/setUserSetZoneConfig
请求方式 POST
Content-Type application/json
header:key Authorization
header:value Bearer YOUR_ACCESS_TOKEN

请求参数：

{
	"zone":""
}
1
2
3

# 修改邮箱

ResultObject updateEmail(code, email)

修改当前用户的邮箱

# 请求参数

名称 类型 描述 备注
code String 邮箱验证码
email String 邮箱

# 返回参数

ResultObject

名称 类型 描述 备注
code String 响应码 -
data Object 响应数据 -
msg String 响应消息 -
time OffsetDateTime 响应时间 -

# java-sdk 调用示例

//实例化api类，传入token
UserApi apiInstance = new UserApi(token);
//实例化请求参数
String code = "code_example";
String email = "email_example";

try {
    ResultObject result = apiInstance.updateEmail(code, email);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("调用UserApi.updateEmail异常: " + e.getMessage());
    e.printStackTrace();
}
1
2
3
4
5
6
7
8
9
10
11
12
13

# HTTP 调用示例

属性 名称
HTTP请求地址 http://[server]:[port]/api-organization/user/updateEmail
请求方式 POST
Content-Type application/json
header:key Authorization
header:value Bearer YOUR_ACCESS_TOKEN

请求参数：

{
	"code":"",
	"email":""
}
1
2
3
4

# 修改密码

ResultObject updatePassword(data)

修改当前用户的密码

# 请求参数

名称 类型 描述 备注
data String 修改密码 Json对象

# 返回参数

ResultObject

名称 类型 描述 备注
code String 响应码 -
data Object 响应数据 -
msg String 响应消息 -
time OffsetDateTime 响应时间 -

# java-sdk 调用示例

//实例化api类，传入token
UserApi apiInstance = new UserApi(token);
//实例化请求参数
String data = "data_example";

try {
    ResultObject result = apiInstance.updatePassword(data);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("调用UserApi.updatePassword异常: " + e.getMessage());
    e.printStackTrace();
}
1
2
3
4
5
6
7
8
9
10
11
12

# HTTP 调用示例

属性 名称
HTTP请求地址 http://[server]:[port]/api-organization/user/updatePassword
请求方式 POST
Content-Type application/json
header:key Authorization
header:value Bearer YOUR_ACCESS_TOKEN

请求参数：

{
	"data":""
}
1
2
3

# 修改当前用户手机号

ResultObject updatePhone(phoneForm)

根据手机号和验证码修改当前用户的手机号

# 请求参数

名称 类型 描述 备注
phoneForm PersonalPhoneForm phoneForm

# PersonalPhoneForm

名称 类型 描述 备注
phone String 手机号
phoneCode String 手机验证码

# 返回参数

ResultObject

名称 类型 描述 备注
code String 响应码 -
data Object 响应数据 -
msg String 响应消息 -
time OffsetDateTime 响应时间 -

# java-sdk 调用示例

//实例化api类，传入token
UserApi apiInstance = new UserApi(token);
//实例化请求参数
PersonalPhoneForm phoneForm = new PersonalPhoneForm();

try {
    ResultObject result = apiInstance.updatePhone(phoneForm);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("调用UserApi.updatePhone异常: " + e.getMessage());
    e.printStackTrace();
}
1
2
3
4
5
6
7
8
9
10
11
12

# HTTP 调用示例

属性 名称
HTTP请求地址 http://[server]:[port]/api-organization/user/updatePhone
请求方式 POST
Content-Type application/json
header:key Authorization
header:value Bearer YOUR_ACCESS_TOKEN

请求参数：

{
	"phone":"",
	"phoneCode":""
}
1
2
3
4

# 修改当前用户基本信息

ResultObject updateUserBaseInfo(userForm)

修改当前用户基本信息

# 请求参数

名称 类型 描述 备注
userForm PersonalUserForm userForm

# PersonalUserForm

名称 类型 描述 备注
address String 地址 -
nickname String 昵称
remark String 用户备注 -
sex Integer 性别(0:男 1:女 2:未知) -

# 返回参数

ResultObject

名称 类型 描述 备注
code String 响应码 -
data Object 响应数据 -
msg String 响应消息 -
time OffsetDateTime 响应时间 -

# java-sdk 调用示例

//实例化api类，传入token
UserApi apiInstance = new UserApi(token);
//实例化请求参数
PersonalUserForm userForm = new PersonalUserForm();

try {
    ResultObject result = apiInstance.updateUserBaseInfo(userForm);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("调用UserApi.updateUserBaseInfo异常: " + e.getMessage());
    e.printStackTrace();
}
1
2
3
4
5
6
7
8
9
10
11
12

# HTTP 调用示例

属性 名称
HTTP请求地址 http://[server]:[port]/api-organization/user/updateUserBaseInfo
请求方式 POST
Content-Type application/json
header:key Authorization
header:value Bearer YOUR_ACCESS_TOKEN

请求参数：

{
	"address":"",
	"sex":0,
	"nickname":"",
	"remark":""
}
1
2
3
4
5
6

# 修改用户全部信息

ResultObject updateUserInfo(updateUserForm)

修改用户信息

# 请求参数

名称 类型 描述 备注
updateUserForm UpdateUserForm updateUserForm

# UpdateUserForm

名称 类型 描述 备注
address String 地址 -
departmentId String 部门ID
email String 电子邮箱 -
id String 用户id
lock Boolean 账号是否锁定(1:锁定 0未锁定)
nickname String 昵称 -
officePhone String 办公电话 -
oldEmail String 旧电子邮箱 -
oldPhone String 旧手机号 -
phone String 手机号 -
phoneCode String 手机验证码 -
remark String 备注 -
roleId String 角色ID
sex Integer 性别(0:男 1:女 2:未知)
source Integer 数据来源(0注册审核,1企业管理菜单中手动添加,2超级用户添加企业时生成,3系统自动添加)
type Integer 类型(1管理员 2普通用户)与实际的type不一样
username String 用户名

# 返回参数

ResultObject

名称 类型 描述 备注
code String 响应码 -
data Object 响应数据 -
msg String 响应消息 -
time OffsetDateTime 响应时间 -

# java-sdk 调用示例

//实例化api类，传入token
UserApi apiInstance = new UserApi(token);
//实例化请求参数
UpdateUserForm updateUserForm = new UpdateUserForm();

try {
    ResultObject result = apiInstance.updateUserInfo(updateUserForm);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("调用UserApi.updateUserInfo异常: " + e.getMessage());
    e.printStackTrace();
}
1
2
3
4
5
6
7
8
9
10
11
12

# HTTP 调用示例

属性 名称
HTTP请求地址 http://[server]:[port]/api-organization/user/updateUserInfo
请求方式 POST
Content-Type application/json
header:key Authorization
header:value Bearer YOUR_ACCESS_TOKEN

请求参数：

{
	"address":"",
	"roleId":"",
	"departmentId":"",
	"oldPhone":"",
	"sex":0,
	"remark":"",
	"source":0,
	"type":0,
	"oldEmail":"",
	"officePhone":"",
	"phone":"",
	"nickname":"",
	"lock":false,
	"phoneCode":"",
	"id":"",
	"email":"",
	"username":""
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
设备
角色

← 角色→

最近更新
01
401-使用说明
 02-07
02
DLT645串口
 02-02
03
英威腾IVC系列串口
 02-02
更多文章>
Copyright © 2021-2026 沪公网安备31011702891182号