文档首页/ ISDP/ API参考/ API接口/ 人员管理/ 人员批量新增(API名称:batchAdd)
更新时间:2024-02-19 GMT+08:00
分享

人员批量新增(API名称:batchAdd)

功能介绍

人员批量新增

相关接口

接口名称

调用说明

获取Token

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

URL

请求方式

HTTPS地址

服务架构

消息体类型

POST

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

OpenAPI

application/json

请求头

KEY

VALUE

是否必填

描述

Content-Type

application/json

Authorization

bearer ${access_token}

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

请求参数

参数

类型

是否必填

描述

personList

List<Map<String,Object>>

人员列表(一次最多支持100条数据更新,可配置saas.person.max-persons来设置最大条数)

personList参数:

参数

类型

是否必填

描述

personGroupId

Long

人员分组id

personCode

String

人员编码

firstName

String

lastName

String

personName

String

人员姓名

qualificationCode

String

作业资质id(多个用英文逗号分隔,必须为数字,且存在该作业资质)

personType

String

人员类型

description

String

描述

email

String

邮箱

phone

String

电话号码

customerCode

String

所属客户编码

supplierCode

String

所属分包商编码

openAccount

Integer

是否开户

headFileId

Long

头像

faceFileId

Long

人脸信息

status

Integer

状态

integrationAccount

String

集成账户

udfExtend1

String

扩展字段1(扩展字段必须启用)

udfExtend2

String

扩展字段2(扩展字段必须启用)

udfExtend3

String

扩展字段3(扩展字段必须启用)

udfExtend4

String

扩展字段4(扩展字段必须启用)

udfExtend5

datetime

扩展字段5(扩展字段必须启用)

udfExtend6

datetime

扩展字段6(扩展字段必须启用)

udfExtend7

String

扩展字段7(扩展字段必须启用)

udfExtend8

String

扩展字段8(扩展字段必须启用)

udfExtend9

String

扩展字段9(扩展字段必须启用)

udfExtend10

String

扩展字段10(扩展字段必须启用)

isSmartDevice

Interger

是否是智能设备

registerFace

Integer

0-未注册,1-已注册

blackList

Integer

黑名单:0-否,1-是

reason

String

原因

electronicSignatureId

Long

电子签名id

language

String

人员语言

certificateType

String

证件类型

certificateNo

String

证件号码

roleNo

String

角色编码(多给以逗号分隔,不能超过5个,不传默认为NormalUser)

响应参数

参数

类型

描述

Status

String

状态描述,请求是否成功

Msg

String

报错信息

Failed

Boolean

请求失败标识

Success

Boolean

请求成功标识

data

Map

返回的数据

请求示例

{
    "personList": [
        {
            "orgNo": "robin_test_4_0",
            "personCode": "h0079969522",
            "personName": "测试人员批量新增",
            "qualificationCode": "61",
            "personType": "Employee",
            "roleNo": "test Role1,robin_test_func",
            "positionCode": "test012,robin_test_postion_01",
            "udfExtend1": "AAA",
            "udfExtend4": "AAA",
            "firstName": "A",
            "lastName": "B",
            "description": "测试人员批量新增",
            "email": "hsc@huawei.com",
            "phone": "13572003291",
            "customerCode": "客户编码3-测试",
            "supplierCode": "T001",
            "openAccount": "1",
            "headFileId": "1",
            "faceFileId": "1",
            "status": "1",
            "integrationAccount": "hw",
            "isSmartDevice": "N",
            "registerFace": 1,
            "blackList": 1,
            "reason": "reason",
            "electronicSignatureId": "1",
            "language": "zh_CN",
            "certificateType": "ID_CARD",
            "certificateNo": "500108191604236113"
        }
    ]
}

响应示例

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

相关文档