通过userId集合查询人员信息(API名称:findPersonByUserIdListPlainText)
功能介绍
该接口通过userId集合查询人员信息(敏感信息不脱敏,如电话号码会完整显示)。
相关API
|
接口名称 |
调用说明 |
|---|---|
|
调用该接口获取到Token,再调用其他接口时,需要在请求消息头中添加“Authorization”,其值即为Token。 |
|
|
调用该接口获取到用户id。 查询人员信息时,需要输入用户id。 |
调用流程
URL
|
请求方式 |
HTTPS地址 |
服务架构 |
消息体类型 |
|---|---|---|---|
|
POST |
https://isdp+域名/openapi/v1/person/findPersonByUserIdListPlainText |
OpenAPI |
application/json |
请求头
|
KEY |
VALUE |
是否必填 |
描述 |
|---|---|---|---|
|
Content-Type |
application/json |
是 |
无 |
|
Authorization |
bearer ${access_token} |
是 |
bearer +“ ”+5.2.1中获取的access_token的值 |
请求参数
|
参数 |
类型 |
是否必填 |
描述 |
|---|---|---|---|
|
userIdList |
List< Number > |
是 |
用户id集合 获取用户id API请参见:查询指定时间范围人员(API名称:getPersonListByRangeTime) |
响应参数
|
参数 |
类型 |
描述 |
|---|---|---|
|
personId |
Long |
人员id |
|
personGroupId |
Long |
人员分组id |
|
blackList |
int |
黑名单 0:否 1:是 |
|
reason |
String |
入黑名单原因 |
|
profilePictureStatus |
String |
证件照状态 |
|
profilePictureId |
Long |
证件照ID |
|
personCode |
String |
人员编码 |
|
firstName |
String |
名 |
|
lastName |
String |
姓 |
|
personName |
String |
人员名称 |
|
qualificationCode |
String |
人员资质 |
|
personType |
String |
人员类型 |
|
tenantId |
Long |
租户id |
|
description |
String |
备注 |
|
phone |
String |
手机号 |
|
adminOrgId |
Long |
组织单元id |
|
orgName |
String |
组织单元 |
|
customerId |
Long |
客户id |
|
customerName |
String |
客户名称 |
|
supplierId |
Long |
供应商id |
|
supplierName |
String |
供应商名称 |
|
openAccount |
String |
是否开户 |
|
account |
String |
账户 |
|
headFileId |
Long |
头像id |
|
faceFileId |
Long |
人脸信息id |
|
integrationAccount |
String |
集成账户 |
|
status |
int |
状态 |
|
lastUpdatedBy |
Long |
最近更新人 |
|
lastUpdateDate |
Date |
最近更新时间 |
|
personStatus |
String |
人员状态 |
|
udfExtend1 |
String |
扩展字段1 |
|
udfExtend2 |
String |
扩展字段2 |
|
udfExtend3 |
String |
扩展字段3 |
|
udfExtend4 |
String |
扩展字段4 |
|
udfExtend5 |
Date |
扩展字段5 |
|
udfExtend6 |
Date |
扩展字段6 |
|
isSmartDevice |
char |
是否智能设备 |
|
userId |
Long |
用户id |
|
personPositionList |
List<Map<String,Object>> |
人员岗位 |
|
PersonPositionNameStr |
String |
人员岗位名称 |
|
personPositionCodeStr |
String |
人员岗位编码 |
请求示例
{
"userIdList":[1859]
}
响应示例
[
{
"personId" : 183663,
"personGroupId" : null,
"blackList" : 0,
"reason" : null,
"profilePictureStatus" : "CollectionSucceeded",
"profilePictureId" : "1325041",
"personCode" : "test",
"firstName" : null,
"lastName" : null,
"personName" : "test",
"qualificationCode" : null,
"personType" : "Admin",
"tenantId" : 1,
"description" : "",
"phone" : "137*******1",
"adminOrgId" : 502,
"orgName" : "超级租户",
"customerId" : null,
"customerName" : null,
"supplierId" : null,
"supplierName" : null,
"openAccount" : null,
"account" : "",
"headFileId" : null,
"faceFileId" : null,
"integrationAccount" : "jczh123",
"status" : 0,
"lastUpdatedBy" : -1,
"lastUpdateDate" : 1631861495000,
"personStatus" : "OpenAccount",
"udfExtend1" : "1",
"udfExtend2" : null,
"udfExtend3" : null,
"udfExtend4" : null,
"udfExtend5" : null,
"udfExtend6" : null,
"isSmartDevice" : null,
"userId" : 1859,
"personPositionList" : [],
"PersonPositionNameStr" : null,
"personPositionCodeStr" : null
}
]
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。