外部人员编码列表查询
- 接口:/common/externalPersons/findByCodesAndType
- Method:GET
- 接口说明:根据外部人员编码列表查询外部人员信息(上限100)
- 多语言环境:实现多语言环境方式是在接口请求头中添加Key为locale,Value值为语言环境,目前支持的语言有zh_CN(中文)、en_US(英文)、ja_JP(日文)、zh_TW(繁体),请选取其中一种
请求参数
字段名称 |
字段类型 |
字段描述 |
是否必填 |
长度 |
bizId |
String |
业务唯一识别码 |
true |
255 |
timestamp |
long |
时间戳 |
true |
13 |
codes |
Array |
外部人员编码集合 |
true |
无 |
type_code |
String |
外部人员类型编码 |
true |
64 |
请求示例
/common/externalPersons/findByCodesAndType?timestamp=1718956026&bizId=1718956026&codes=323&type_code=testtest
返回参数
默认返参
字段名称 |
字段类型 |
字段描述 |
resCode |
Integer |
状态码 |
resMsg |
String |
描述 |
bizId |
String |
业务唯一识别码 |
data[0].code |
String |
外部人员编码 |
data[0].email_address |
String |
外部人员邮箱 |
data[0].mobile |
String |
外部人员手机号 |
data[0].staff_flag |
String |
是否按权限管控标志(Y/N) |
data[0].enabled_flag |
String |
启用标识 |
data[0].type_code |
String |
外部人员类型编码 |
data[0].type_name |
String |
外部人员类型名称 |
data[0].last_update_date |
Date |
最后更新时间 |
可配置返参
字段名称 |
字段类型 |
字段描述 |
data[0].gender |
String |
外部人员性别 |
data[0].birthday |
Date |
外部人员生日 |
data[0].nationality |
String |
国籍 |
data[0].attribute1-5 |
String |
attribute1-50的字段信息 |
data[0].column1-50 |
String |
column1-50的字段信息,要返回自定义字段的其他信息,将以类似column1_vo(JSONObject)的形式返回 |
返回示例
{
"resCode": 200000,
"resMsg": "本次共查询到1个外部人员,其中外部人员编号[]不存在",
"bizId": "1718956026",
"data": [
{
"code": "323",
"mobile": "234",
"last_update_date": 1718242253000,
"full_name": "223",
"email_address": "1234",
"enabled_flag": "Y",
"type_code": "testtest",
"type_name": "testname修改"
}
]
}