人员批量新增 - API开发者文档

请求参数

Body 参数application/json

token

string

用户Token

必需

dataPersonInfo

array [object {18}]

必需

operType

string

必需

操作类型(0添加 1删除,如果为1删除则只传入uId即可,其它参数可不传)(必添)

uId

string

可选

账号(第三方唯一,一般为第三方自己平台的id)

accountNo

string

工/学号

必需

personName

string

姓名

必需

personType

string

必需

人员类型:0:学生 1:老师 2:员工 3:协力员工(必添)

sex

string

必需

性别(男、女)(必添)

depCode

string

必需

部门/班级编号、接口调用方编号(必添)

depName

string

必需

部门名称/班级名称、接口调用方编号(必添)

depType

string

必需

0表示部门,1表示年级,2表示班级,3表示学部/院区,-1表示任意接口调用方编号(必添)

depParentCode

string

必需

上级部门/班级编号、接口调用方编号(必添,如自身就是顶级,传空即可)

phoneNumber

string

联系电话(选添)

可选

flagNo

string

可选

人员身份编号(选添)

idCard

string

身份证号(选添)

可选

cardNo

string

IC卡卡号(选添)

可选

roomCode

string

入住房间号(选添)

可选

startDate

string

有效期始

可选

endDate

string

有效期止

可选

createAccountNo

string

可选

建档人(选添-智慧楼宇时必添)

示例

{
    "token": "string",
    "dataPersonInfo": [
        {
            "operType": "string",
            "uId": "string",
            "accountNo": "string",
            "personName": "string",
            "personType": "string",
            "sex": "string",
            "depCode": "string",
            "depName": "string",
            "depType": "string",
            "depParentCode": "string",
            "phoneNumber": "string",
            "flagNo": "string",
            "idCard": "string",
            "cardNo": "string",
            "roomCode": "string",
            "startDate": "string",
            "endDate": "string",
            "createAccountNo": "string"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'http://tx03.55kad.com/api/v2/BaseInfo/BatchAddPersonByV3' \
--header 'Content-Type: application/json' \
--data-raw '{
    "token": "string",
    "dataPersonInfo": [
        {
            "operType": "string",
            "uId": "string",
            "accountNo": "string",
            "personName": "string",
            "personType": "string",
            "sex": "string",
            "depCode": "string",
            "depName": "string",
            "depType": "string",
            "depParentCode": "string",
            "phoneNumber": "string",
            "flagNo": "string",
            "idCard": "string",
            "cardNo": "string",
            "roomCode": "string",
            "startDate": "string",
            "endDate": "string",
            "createAccountNo": "string"
        }
    ]
}'

返回响应

🟢200OK

application/json

Body

结果对象

resultCode

string

可选

返回值(0成功 1失败)

resultMsg

string

返回信息

可选

rows

array[object (PersonRowsDataList) {13}]

数据列表

可选

cardState

string

可选

1正常 2挂失或冻结

cardNo

string

可选

卡号(标准维根34卡号)

studentNO

string

工号/学号

可选

studentName

string

姓名

可选

cardBalance

string

帐户余额(元)

可选

posValidDate

string

就餐有效期

可选

passValidDate

string

通行有效期

可选

buildDate

string

办卡日期

可选

Incompilation

string

是否在编(是、否)

可选

MySpace

string

可选

学芒网盘个人空间(G)

PublicSpace

string

可选

学芒网盘公共空间(G)

IsSignAContract

string

可选

BankCardNo

string

可选

resultdata

array[object (resultData) {3}]

数据列表

可选

resultCode

string

可选

返回值(0成功 1失败)

resultMsg

string

返回信息

可选

resultRows

object

返回数据

可选

示例

{
    "resultCode": "string",
    "resultMsg": "string",
    "rows": [
        {
            "cardState": "string",
            "cardNo": "string",
            "studentNO": "string",
            "studentName": "string",
            "cardBalance": "string",
            "posValidDate": "string",
            "passValidDate": "string",
            "buildDate": "string",
            "Incompilation": "string",
            "MySpace": "string",
            "PublicSpace": "string",
            "IsSignAContract": "string",
            "BankCardNo": "string"
        }
    ],
    "resultdata": [
        {
            "resultCode": "string",
            "resultMsg": "string",
            "resultRows": {}
        }
    ]
}