根据ID更新人员信息（API名称：person/update）
功能介绍
根据ID更新人员信息
相关接口
接口名称 |
调用说明 |
|---|---|
调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加“Authorization”，其值即为Token。 |
URL
请求方式 |
HTTPS地址 |
服务架构 |
消息体类型 |
|---|---|---|---|
POST |
https://isdp+域名/openapi/v1/person/update |
OpenAPI |
application/json |
请求头
KEY |
VALUE |
是否必填 |
描述 |
|---|---|---|---|
Content-Type |
application/json |
是 |
无 |
Authorization |
bearer ${access_token} |
是 |
bearer +“ ”+5.2.1中获取的access_token的值 |
请求参数
参数 |
类型 |
是否必填 |
描述 |
|---|---|---|---|
personId |
String |
是 |
人员ID |
personCode |
String |
是 |
人员编码 |
personName |
String |
是 |
人员姓名 |
personType |
String |
是 |
人员类型，可选项Admin、Customer、Employee、Supplier、Other |
phone |
String |
是 |
电话号码 |
personStatus |
String |
是 |
人员状态，OC场景固定值NoAccountOpened，OP环境和红蓝一体固定值OpenAccount |
adminOrgId |
String |
是 |
所属行政组织id（部门） |
activeFlag |
String |
否 |
是否自动发送激活短信，Y：自动发送 |
qualificationCode |
String |
否 |
作业资质id（多个用英文逗号分隔） |
extPerson |
Map |
否 |
人员扩展信息，根据具体业务填写 |
password |
String |
否 |
密码，OP环境支持修改密码 |
certificateType |
String |
否 |
证件类型，增加证件时必填，可选项： PASSPORTS、ID_CARD |
certificateNo |
String |
否 |
证件号码 |
roleRuleList |
List<Map> |
否 |
需要授权的角色（多个用英文逗号分隔） |
qualificationList |
List<Map> |
否 |
人员技能 |
personPositionList |
List<Map> |
否 |
人员岗位 |
profilePictureId |
String |
否 |
证件照id |
extPerson参数
参数 |
类型 |
描述 |
|---|---|---|
gender |
String |
性别 |
nation |
String |
民族 |
birthplace |
String |
籍贯 |
birthdate |
String |
出生日期 |
employeeID |
String |
工号 |
accessTime |
String |
入路时间 |
accessMode |
String |
入路方式 |
politicalProfile |
String |
政治面貌 |
timeOfJoinCommunistParty |
String |
入党时间 |
timeOfJoinCommunistYouthLeague |
String |
入团时间 |
homeAddress |
String |
家庭住址 |
fatherName |
String |
父亲姓名 |
fatherWorkCompany |
String |
父亲工作单位 |
fatherPosition |
String |
父亲职务 |
motherName |
String |
母亲姓名 |
motherWorkCompany |
String |
母亲工作单位 |
motherPosition |
String |
母亲职务 |
spouseName |
String |
配偶姓名 |
spouseWorkCompany |
String |
配偶工作单位 |
spousePosition |
String |
配偶职务 |
degree |
String |
学位 |
professional |
String |
专业 |
graduationSchool |
String |
毕业学校 |
graduationTime |
String |
毕业时间 |
qualificationList参数
参数 |
类型 |
描述 |
|---|---|---|
skillDomainName |
String |
技能种类 |
skillName |
String |
技能名称 |
skillLevelName |
String |
技能等级 |
startDate |
String |
证书开始时间 |
endDate |
String |
证书结束时间 |
hireStatus |
Integer |
是否在聘，1在聘，0未在聘 |
roleRuleList列表内的Map参数
参数 |
类型 |
描述 |
|---|---|---|
roleNo |
String |
角色编号 |
ruleCode |
String |
规则编码 |
personPositionList列表内的Map参数
参数 |
类型 |
描述 |
|---|---|---|
positionId |
String |
岗位ID |
响应参数
参数 |
类型 |
描述 |
|---|---|---|
Status |
String |
状态描述，请求是否成功 |
Msg |
String |
报错信息 |
Failed |
Boolean |
请求失败标识 |
Success |
Boolean |
请求成功标识 |
请求示例
{
"personId": "5001540",
"personCode": "test0727",
"personName": "test0727",
"personType": "Employee",
"phone": "13822150727",
"personStatus": "NoAccountOpened",
"adminOrgId": "9911293975",
"activeFlag": "Y",
"qualificationCode": "68,69",
"certificateNo": "440155200006018888",
"certificateType": "ID_CARD",
"extPerson": {
"gender": "female",
"nation": "cn"
},
"qualificationList": [
{
"personQualId": "5000049",
"skillName": "急救证",
"skillLevelName": "1级",
"skillDomainName": "安全",
"hireStatus": 1
}
],
"personPositionList": [
{
"positionId": "112524"
}
]
}
响应示例
{
"status": "success",
"msg": null,
"data": null,
"failed": false,
"success": true
}
