文档首页/ ISDP/ API参考/ API接口/ 人员管理/ 新增人员账号（API名称：person/add）
更新时间：2024-04-26 GMT+08:00
查看PDF
分享

新增人员账号（API名称：person/add）

功能介绍

该接口用于自动添加人员账号（以及给人员账号授予角色）。

相关API

接口名称

调用说明

获取Token

调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加“Authorization”，其值即为Token。

调用流程

图1 添加人员账号流程

URL

请求方式

HTTPS地址

服务架构

消息体类型

POST

https://isdp+域名/openapi/v1/person/add

OpenAPI

application/json

请求头

KEY

VALUE

是否必填

描述

Content-Type

application/json

是

无

Authorization

bearer ${access_token}

是

bearer +“ ”+5.2.1中获取的access_token的值

请求参数

参数

类型

是否必填

描述

personCode

String

是

人员编码

personName

String

是

人员姓名

personType

String

是

人员类型，可选项Admin、Customer、Employee、Supplier、Other

phone

String

是

电话号码

personStatus

String

否

人员状态，OC场景固定值NoAccountOpened，OP环境和红蓝一体固定值OpenAccount

activeFlag

String

否

是否自动发送激活短信，Y：自动发送

qualificationCode

String

否

作业资质id（多个用英文逗号分隔）

adminOrgId

String

否

所属行政id（部门）

extPerson

Map

否

人员扩展信息，根据具体业务填写

password

String

否

密码，OP环境支持修改密码

certificateType

String

否

证件类型，增加证件时必填，可选项：

PASSPORTS、ID_CARD

certificateNo

String

否

证件号码

qualificationList

List<Map>

否

人员技能

roleRuleList

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列表内的Map参数

参数

类型

描述

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

请求成功标识

请求示例

{
    "personCode": "test0727",
    "personName": "test0727",
    "personType": "Employee",
    "phone": "13822150727",
    "activeFlag": "Y",
    "qualificationCode": "68,69",
    "certificateNo": "440155200006019874",
    "password": "07******",
    "certificateType": "ID_CARD",
    "extPerson": {
        "gender": "female",
        "nation": "cn"
    },
    "qualificationList": [
        {
            "skillName": "急救证",
            "skillLevelName": "1级",
            "skillDomainName": "安全",
            "hireStatus": 1
        }
    ],
    "personPositionList": [
        {
            "positionId": "5000804"
        }
    ]
}

响应示例

{
    "status": "success",
    "msg": null,
    "data": null,
    "failed": false,
    "success": true
}

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。

父主题： 人员管理

相关文档