人员外部主键列表查询
- 接口:/common/users/v2/findByBindIds
- Method:POST
- 接口说明:根据用户外部主键列表查询用户信息(上限100)
- 多语言环境:实现多语言环境方式是在接口请求头中添加Key为locale,Value值为语言环境,目前支持的语言有zh_CN(中文)、en_US(英文)、ja_JP(日文)、zh_TW(繁体),请选取其中一种
请求参数
| 字段名称 |
字段类型 |
字段描述 |
是否必填 |
长度 |
| bizId |
String |
业务唯一识别码 |
true |
255 |
| timestamp |
long |
时间戳 |
true |
无 |
| platform |
String |
渠道(例如ctrip) |
true |
255 |
| bind_ids |
List |
人员外部主键列表 |
true |
无 |
请求示例
{
"bizId": "4e13e967-50c3-40a3-bde2-7b4aa164ece7",
"timestamp": 1594017230978,
"platform": "ctrip",
"bind_ids": [
"1234"
]
}
返回参数
| 字段名称 |
字段类型 |
字段描述 |
| resCode |
Integer |
状态码 |
| resMsg |
String |
描述 |
| data |
List |
数据结果列表 |
UserWithBindingVo
默认返参
| 字段名称 |
字段类型 |
字段描述 |
| platform |
String |
渠道名 |
| bind_id |
String |
人员外部主键 |
| user_name |
String |
用户名 |
| code |
String |
编码( 即员工号) |
| full_name |
String |
全名 |
| email_address |
String |
邮箱 |
| gender |
String |
性别 |
| mobile |
String |
手机号 |
| department.department.code |
String |
部门编码 |
| department.department_name |
String |
部门名称 |
| inactive_date |
long |
失效时间 |
| ####可配置返参 |
|
|
| 字段名称 |
字段类型 |
字段描述 |
| :----------------------------- |
:------- |
:----------- |
| surname |
String |
姓 |
| given_name |
String |
名 |
| description |
String |
描述 |
| dingtalk_name |
String |
钉钉号 |
| dingtalk_unionid |
String |
钉钉unionid |
| feishu_name |
String |
飞书号 |
| wechatqy_name |
String |
企业微信号 |
| sub_company |
String |
子公司 |
| parent.* |
JSONObject |
关联上级字段,相关表为fnd_user |
| approval_level |
int |
审批级别 |
| base_city |
int |
所在城市 |
| base_city.* |
JSONObject |
关联的城市信息,相关表fnd_city,dic_city |
| birthday |
date |
生日 |
| profession |
string |
职业 |
| nationality |
string |
国籍 |
| telephone |
string |
电话 |
| address |
string |
地址 |
| postcode |
string |
邮政编码 |
| department.* |
JSONObject |
关联的部门信息,相关表fnd_department |
| cost_center.* |
JSONObject |
关联的部门信息,相关表fnd_department |
| branch.* |
JSONObject |
关联的部门信息,相关表fnd_department |
| position.* |
JSONObject |
关联的部门信息,fnd_position |
| level.* |
JSONObject |
关联的部门信息,fnd_level |
| date_of_joining |
date |
入职日期 |
| resignation_date |
date |
离职日期 |
| start_work_date |
date |
开始工作时间 |
| default_language |
String |
默认语言 |
| sub_account_name |
String |
子账号名称 |
| credit_score |
int |
信用分 |
| credit_level |
int |
信用等级 |
| point_balance |
decimal |
积分余额 |
| point_frozen |
decimal |
积分冻结 |
| column1-column50 |
string |
column字段对应的名称 |
| attribute1-attribute5 |
string |
attribute字段对应的名称 |
| creation_date |
date |
创建日期 |
| last_update_date |
date |
最后更新日期 |
返回示例
{
"resCode": 200000,
"resMsg": "success",
"bizId": "4e13e967-50c3-40a3-bde2-7b4aa164ece7",
"data": [
{
"code": "0426-8888",
"mobile": "13082343432",
"gender": "M",
"email_address": "124132412@qq.com",
"full_name": "测试0426-4",
"employee_number": "0426-8888",
"user_name": "0426-399990090",
"department_vo": {
"code": "D1",
"department_name": "Tiny ship_zh_CN(D1)",
"department_code": "D1"
},
"platform": "ctrip",
"bind_id": "1234"
}
]
}