查询租户下用户信息（API名称：getPersonListByTenant）
功能介绍
该接口用于查询当前租户下的用户信息：人员名称、归属分包商、人员状态等信息。
相关API
|
接口名称 |
调用说明 |
|---|---|
|
调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加“Authorization”，其值即为Token。 |
调用流程
URL
|
请求方式 |
HTTPS地址 |
服务架构 |
消息体类型 |
|---|---|---|---|
|
POST |
https://isdp+域名/openapi/v1/person/getPersonListByTenant |
OpenAPI |
application/json |
请求头
|
KEY |
VALUE |
是否必填 |
描述 |
|---|---|---|---|
|
Content-Type |
application/json |
是 |
无 |
|
Authorization |
bearer ${access_token} |
是 |
bearer +“ ”+5.2.1中获取的access_token的值 |
请求参数
|
参数 |
类型 |
是否必填 |
描述 |
|---|---|---|---|
|
start |
int |
是 |
开始位置，不传默认0 |
|
count |
int |
是 |
每页总数，不传默认50 |
|
idList |
Array |
否 |
人员id集合 |
|
personCodeList |
String |
否 |
人员账号批量精确查询，多个用英文逗号分隔 |
|
keyWords |
String |
否 |
人员账号或者人员名称过滤，OP为全模糊，OC为右模糊 |
|
personStatus |
String |
否 |
人员状态编码NoAccountOpened;OpeningAccount;OpenAccount;Freeze;Cancel，多个用英文分号分隔
注意：
不传默认将已注销人员查询出来 |
|
personType |
String |
否 |
人员类型编码Admin;Customer;Employee;Other;Supplier，多个用英文分号分隔 |
|
isSmartDevice |
String |
否 |
是否查询智能设备账号，Y：不查询智能设备账号， 其它：查询智能设备账号
注意：
不传此参数查询结果包含智能设备账号 |
|
orgIdList |
Array |
否 |
所属组织id集合 |
|
orgIncludeChild |
Boolean |
否 |
是否包含所属组织的子级组织 |
|
orgNoList |
Array |
否 |
所属组织编码集合 |
|
orgName |
String |
否 |
单个组织名称则为右模糊查询，多个用英文分号分隔则为精确批量查询 |
|
customerCode |
String |
否 |
单个客户编码则为右模糊查询，多个用英文分号分隔则为精确批量查询 |
|
customerName |
String |
否 |
单个客户名称则为右模糊查询，多个用英文分号分隔则为精确批量查询 |
|
supplierCode |
String |
否 |
单个供应商编码则为右模糊查询，多个用英文分号分隔则为精确批量查询 |
|
supplierName |
String |
否 |
单个供应商名称则为右模糊查询，多个用英文分号分隔则为精确批量查询 |
|
profilePictureStatus |
String |
否 |
工作照状态，已上传：CollectionSucceeded，未上传：CollectionFailed |
响应参数
|
参数 |
类型 |
描述 |
|---|---|---|
|
personId |
Long |
人员id |
|
personCode |
String |
人员账号 |
|
personName |
String |
人员名称 |
|
personTypeCode |
String |
人员类型编码 |
|
personType |
String |
人员类型名称 |
|
personStatusCode |
String |
人员状态编码 |
|
personStatus |
String |
人员状态名称 |
|
orgId |
Long |
所属组织id |
|
orgNo |
String |
所属组织编码 |
|
orgName |
String |
所属组织名称 |
|
customerId |
Long |
所属客户id |
|
customerCode |
String |
所属客户编码 |
|
customerName |
String |
所属客户名称 |
|
supplierId |
Long |
所属分包商id |
|
supplierCode |
String |
所属分包商code |
|
supplierName |
String |
所属分包商名称 |
|
positionCode |
String |
人员岗位编码 |
|
positionName |
String |
人员岗位名称 |
|
profilePictureStatusCode |
String |
工作照状态，CollectionSucceeded:已注册、CollectionFailed:未注册 |
|
profilePictureStatus |
String |
工作照状态 |
|
userId |
Long |
用户id |
|
phone |
String |
手机号码，脱敏返回 |
|
integrationAccount |
String |
集成账号 |
|
qualificationName |
String |
技能名称 |
|
role |
Map<StringObject> |
角色信息 |
role参数说明：
|
参数 |
类型 |
描述 |
|---|---|---|
|
id |
Long |
角色id |
|
roleId |
Long |
角色id |
|
roleName |
String |
角色名称 |
|
roleNo |
String |
角色编号 |
|
deletFlag |
Int |
删除标志 |
|
createdBy |
Long |
创建人 |
|
creationDate |
String |
创建时间 |
|
lastUpdatedBy |
Long |
更新人 |
|
lastUpdateDate |
String |
更新时间 |
|
tenantId |
Long |
Long |
|
entityName |
String |
String |
|
appName |
String |
String |
|
roleType |
Int |
角色类型, 1 系统默认角色,2 自定义角色 |
|
orderNum |
Int |
角色排序 |
|
value |
String |
角色名称 |
|
roleName |
String |
角色名称 |
|
roleDesc |
String |
角色说明 |
请求示例
{
"personStatus": "NoAccountOpened;OpeningAccount;OpenAccount;Freeze",
"isSmartDevice": "Y",
"count": 1,
"start": 0
}
响应示例
{
"data": [
{
"personStatus": "已开户",
"udfExtend9": null,
"supplierId": 84,
"role": {
"id": -998,
"roleId": -998,
"roleNo": "Admin",
"status": "",
"deleteFlag": 0,
"createdBy": 641524227610000,
"creationDate": "2016-11-19 19:11:00",
"lastUpdatedBy": 641524227610000,
"lastUpdateDate": "2016-11-19 19:11:00",
"tenantId": 1,
"entityName": "Role",
"appName": "pub-privilege",
"roleType": 1,
"orderNum": 80,
"value": "Admin",
"roleName": "Admin",
"roleDesc": "Admin"
},
"lastUpdateDate": "2023-07-27T23:59:27.000+08:00",
"udfExtend2": "项目",
"customerCode": "test1",
"positionCode": null,
"udfExtend1": "1",
"udfExtend4": null,
"supplierCode": null,
"udfExtend3": null,
"udfExtend6": null,
"udfExtend5": null,
"personCode": "superman",
"orgId": 502,
"qualificationName": "急救证",
"udfExtend8": null,
"udfExtend7": null,
"positionName": null,
"orgNo": "01",
"customerId": 3001569,
"udfExtend10": null,
"personType": "管理员",
"supplierName": null,
"lastUpdatedBy": -1,
"integrationAccount": "",
"orgName": "save",
"profilePictureStatusCode": "CollectionSucceeded",
"personTypeCode": "Admin",
"personStatusCode": "OpenAccount",
"userId": -1,
"customerName": "xxx",
"personName": "超级管理员",
"phone": "{sa**************************************************************PC",
"profilePictureStatus": "已注册",
"personId": -1
}
],
"pos": 0,
"total_count": 4114,
"entityName": "person",
"totalCount": 4114
}
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。
