根据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": "138****0727",
"personStatus": "NoAccountOpened",
"adminOrgId": "9911293975",
"activeFlag": "Y",
"qualificationCode": "68,69",
"certificateNo": "440********6018888",
"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
}
