- system
- access
- app
- common
- data
- dict
- log
- module
- ops
- role
- tenant
- user
- notify
- area
- project
- slot
- dept
- job
- open
- data
获取用户信息
POST
/api/v1/system/user/info/read
system/user/infosystemUserInfo
请求参数
Header 参数
Ithings-Project-Id
string
可选
默认值:
{{Ithings-Project-Id}}
Ithings-Token
string
可选
默认值:
{{iThings-token}}
app-code
string
可选
默认值:
{{appCode}}
device-id
string
可选
Body 参数application/json
userID
string
用户id
withRoles
boolean
可选
withTenant
boolean
可选
withDepts
boolean
可选
示例
{
"userID": "string",
"withRoles": true,
"withTenant": true,
"withDepts": true
}示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/v1/system/user/info/read' \
--header 'Ithings-Project-Id: {{Ithings-Project-Id}}' \
--header 'Ithings-Token: {{iThings-token}}' \
--header 'app-code: {{appCode}}' \
--header 'device-id;' \
--header 'Content-Type: application/json' \
--data-raw '{
"userID": "string",
"withRoles": true,
"withTenant": true,
"withDepts": true
}'返回响应
🟢200成功
application/json
Body
code
integer
返回code
默认值:
200
msg
string
返回的消息
data
object (UserInfo)
可选
userID
string
用户id
userName
string
用户名(唯一)
password
string
登录密码
email
string
邮箱
phone
string
手机号
lastIP
string
最后登录ip
regIP
string
注册ip
nickName
string
用户的昵称
city
string
用户所在城市
country
string
用户所在国家
province
string
用户所在省份
language
string
可选
headImg
string
用户头像
isUpdateHeadImg
boolean
用户头像
deviceCount
integer <int64>
可选
createdTime
string
创建时间
role
integer <int64>
用户角色默认
sex
integer <int64>
可选
isAllData
integer <int64>
可选
deptIDs
array[string]
部门ID列表
status
integer <int64>
可选
tags
object
标签对象
messageNotRead
object
可选
roles
array[object (RoleInfo) {6}]
可选
tenant
object (TenantInfo)
可选
projects
array[object (ProjectInfo) {18}]
项目列表
depts
array[object (DeptInfo) {11}]
可选
示例
{
"code": "200",
"msg": "string",
"data": {
"userID": "string",
"userName": "string",
"password": "string",
"email": "string",
"phone": "string",
"lastIP": "string",
"regIP": "string",
"nickName": "string",
"city": "string",
"country": "string",
"province": "string",
"language": "string",
"headImg": "string",
"isUpdateHeadImg": true,
"deviceCount": 0,
"createdTime": "string",
"role": 0,
"sex": 0,
"isAllData": 0,
"deptIDs": [
"string"
],
"status": 0,
"tags": {},
"messageNotRead": {},
"roles": [
{
"id": 0,
"name": "string",
"desc": "string",
"createdTime": 0,
"status": 0,
"code": "string"
}
],
"tenant": {
"id": 0,
"code": "string",
"name": "string",
"adminUserID": "string",
"adminRoleID": 0,
"desc": "string",
"defaultProjectID": 0,
"backgroundColour": "string",
"backgroundDesc": "string",
"backgroundImg": "string",
"footer": "string",
"isUpdateBackgroundImg": true,
"logoImg": "string",
"isUpdateLogoImg": true,
"title": "string",
"titleEn": "string",
"createdTime": "string",
"status": 0,
"userCount": 0,
"adminUserInfo": {
"userID": "string",
"userName": "string",
"email": "string",
"phone": "string",
"lastIP": "string",
"regIP": "string",
"nickName": "string",
"headImg": "string",
"tags": {},
"createdTime": "string"
},
"defaultProject": {
"createdTime": "string",
"projectID": "string",
"projectName": "string",
"adminUserID": "string",
"position": {
"longitude": 180,
"latitude": 90
},
"address": "string",
"projectImg": "string",
"isSysCreated": 0,
"isUpdateProjectImg": true,
"desc": "string",
"tags": {},
"areaCount": 0,
"userCount": 0,
"deviceCount": 0,
"ppsm": 0,
"area": 0,
"adminUser": {
"userID": "string",
"userName": "string",
"email": "string",
"phone": "string",
"lastIP": "string",
"regIP": "string",
"nickName": "string",
"headImg": "string",
"tags": {},
"createdTime": "string"
},
"areas": [
{
"createdTime": "string",
"projectID": "string",
"areaID": "string",
"parentAreaID": "string",
"areaName": "string",
"position": {
"longitude": 180,
"latitude": 90
},
"desc": "string",
"tags": {},
"lowerLevelCount": 0,
"deviceCount": 0,
"groupCount": 0,
"useBy": "string",
"isLeaf": 0,
"isSysCreated": 0,
"areaIDPath": "string",
"areaNamePath": "string",
"areaImg": "string",
"isUpdateAreaImg": true,
"configFile": "string",
"isUpdateConfigFile": true,
"children": [
{}
]
}
]
}
},
"projects": [
{
"createdTime": "string",
"projectID": "string",
"projectName": "string",
"adminUserID": "string",
"position": {
"longitude": 180,
"latitude": 90
},
"address": "string",
"projectImg": "string",
"isSysCreated": 0,
"isUpdateProjectImg": true,
"desc": "string",
"tags": {},
"areaCount": 0,
"userCount": 0,
"deviceCount": 0,
"ppsm": 0,
"area": 0,
"adminUser": {
"userID": "string",
"userName": "string",
"email": "string",
"phone": "string",
"lastIP": "string",
"regIP": "string",
"nickName": "string",
"headImg": "string",
"tags": {},
"createdTime": "string"
},
"areas": [
{
"createdTime": "string",
"projectID": "string",
"areaID": "string",
"parentAreaID": "string",
"areaName": "string",
"position": {
"longitude": 180,
"latitude": 90
},
"desc": "string",
"tags": {},
"lowerLevelCount": 0,
"deviceCount": 0,
"groupCount": 0,
"useBy": "string",
"isLeaf": 0,
"isSysCreated": 0,
"areaIDPath": "string",
"areaNamePath": "string",
"areaImg": "string",
"isUpdateAreaImg": true,
"configFile": "string",
"isUpdateConfigFile": true,
"children": [
{}
]
}
]
}
],
"depts": [
{
"id": "string",
"parentID": "string",
"idPath": "string",
"name": "string",
"sort": 0,
"desc": "string",
"userCount": 0,
"status": 0,
"dingTalkID": "string",
"parent": {},
"children": [
{}
]
}
]
}
}修改于 2025-05-27 11:09:16