文档首页/ ISDP/ API参考/ API接口/ 人员管理/ 通过userId集合查询人员信息（API名称：findPersonByUserIdListPlainText）
更新时间：2024-07-22 GMT+08:00
查看PDF
分享

通过userId集合查询人员信息（API名称：findPersonByUserIdListPlainText）

功能介绍

该接口通过userId集合查询人员信息（敏感信息不脱敏，如电话号码会完整显示）。

相关API

接口名称

调用说明

获取Token

调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加“Authorization”，其值即为Token。

查询指定时间范围人员

调用该接口获取到用户id。

查询人员信息时，需要输入用户id。

调用流程

图1 查询人员信息流程

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" : "13700000001",
       "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
    }
]

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。

父主题： 人员管理

相关文档