根据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
}