人员新增 - API开发者文档

需要先调用/v2/BaseInfo/AddDepartment添加部门、可选(/v2/BaseInfo/GetUserRoleList查询角色编号、/v2/BaseInfo/GetIdentityList查询身份编号)

请求参数

Query 参数

uId

string

必需

账号(接口调用方唯一,一般为接口调用方自己平台的id)(必添)

personName

string

姓名(必添)

必需

accountNo

string

工/学号(必添)

必需

personType

string

必需

人员类型:0:学生、1:老师(必添) 政企场景下: 0:正式员工 1:协力员工

sex

string

必需

性别(男、女)(必添)

identityCode

string

身份编号(选添)

可选

depCode

string

必需

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

birthDate

string

出生日期(选添)

可选

phoneNumber

string

联系电话(选添)

可选

token

string

必需

秘钥(用户凭证) (必添)

idCard

string

身份证号(选添)

可选

roleCode

string

可选

用户角色编号(通过获取用户角色接口进行获取)(选添)

cardNo

string

卡号(选添)

可选

QRCode

string

可选

二维码(字符串类型)(选添)

national

string

民族(选添)

可选

politicsStatus

string

政治面貌(选添)

可选

cardType

string

可选

身份证件类型(选添)

entranceDate

string

可选

入学时间/入本单位时间(选添)

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢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": {}
        }
    ]
}