API开发者文档
  1. 人员管理
API开发者文档
  • 变更履历
  • 对接指南
    • 准备工作
  • 基础资源
    • 角色管理
      • 角色查询
      • 角色新增
      • 角色修改
      • 角色删除
      • 功能菜单查询
      • 角色功能菜单授权
    • 部门管理
      • 部门查询
      • 部门新增
      • 部门修改
      • 部门删除
      • 部门查询(根据我方部门编号)
    • 身份管理
      • 身份查询
    • 人员管理
      • 人员新增
        GET
      • 人员批量新增
        POST
      • 修改人员
        GET
      • 根据账号修改人员
        GET
      • 删除人员(根据第三方Id)
        GET
      • 删除人员(根据工/学号)
        GET
      • 人员更换部门
        POST
      • 个人信息查询
        GET
      • 个人详情查询
        GET
      • 个人详情查询(根据身份证号)
        GET
      • 人员详情列表查询(根据学校/政企8位编码)
        GET
      • 增量人员数据获取(根据人员变动时间)
        GET
      • 人员信息列表查询(根据我方班级/部门编号 (不返回uid))
        POST
      • 人员信息列表查询(根据第三方班级/部门编号)
        GET
      • 授权管理范围
        POST
      • 工/学号变更(根据第三方Id)
        POST
    • 家长管理
      • 家长查询
      • 家长新增
      • 家长修改
    • 人脸照片
      • 人脸照片更换(根据工/学号)
      • 人脸照片更换(根据第三方Id)
      • 人脸照片(根据第三方Id)
    • 场所区域管理
      • 场所区域查询
    • 一卡通管理
      • 卡挂失/解挂
      • 卡新增
      • 换卡
      • 卡销户
      • 卡通行有效期变更
      • 卡状态查询
    • 个人密码
      • 帐户密码变更
      • 卡密码变更
      • 帐户密码验证
    • 系统字典
      • 根据字典类别获取属性内容接口
    • 生成二维码字符串
      POST
  • 电子班牌
    • 教室管理
      • 教室查询
      • 教室新增
      • 教室修改
      • 教室删除
    • 课程管理
      • 课程修改
      • 课程删除
      • 课程新增
    • 设备管控
      • 重启设备
      • 关闭设备
    • 课表管理
      • 添加学年学期学期
      • 添加教室课表
      • 添加学生课表
      • 删除教室单节课表
      • 删除学生单节课表
      • 删除教室课表
      • 删除学生单节课表/给学生退课
      • 根据第三方教师id获取课程表
      • 根据教师工号获取课程表
      • 根据学生工号获取课程表
      • 根据班级id获取课程表
      • 根据设备编号获取课程表
    • 班级作业管理
      • 获取班级作业列表
      • 添加班级作业
      • 编辑班级作业
      • 删除班级作业
    • 通知管理
      • 获取所有学校通知
      • 添加学校/班级通知
      • 编辑学校/班级通知
      • 删除学校通知
    • 实时播报
      • 添加校园实时播报
      • 编辑校园实时播报
      • 删除校园实时播报
      • 添加班级实时播报
      • 编辑班级实时播报
      • 删除班级实时播报
    • 考勤管理
      • 根据课程id获取上课人员
      • 根据课程id获取本课程学生出勤汇总
      • 根据课程id获取本课程学生出勤明细
      • 课堂实时考勤数据统计分析
      • 课堂实时考勤数据详细
      • 获取电子班牌考勤明细
      • 获取教师授课考勤明细
    • 相册管理
      • 获取所有相册列表
      • 获取相册图片地址
      • 获取全部相册列表及内容
    • 班牌操作
      • 教室,班牌,班级关联绑定
      • 电子班牌远程开门
      • 教室,班牌,班级解绑
      • 电子班牌下载数据
      • 班牌刷新
      • 电子班牌初始化
      • 设备绑定班级教室教师接口
    • 家长留言信息管理
      • 家长留言接口(学生可在电子班牌端查看)
      • 根据日期获取学生给家长的留言信息
    • 设备信息管理
      • 获取班牌设备列表
    • 课程同步管理
      • 多作息课程同步
    • 班主任管理
      • 班主任简介设置
      • 关联班主任
      • 获取班主任和班级的绑定关系
  • 请假管理
    • 获取请假类别列表
    • 个人请假
    • 销假
    • 获取请假列表
    • 获取当前时间某人请假信息
  • 消息推送管理
    • 订阅消息推送报文格式
    • 可订阅消息查询
    • 消息推送订阅
    • 取消订阅
  1. 人员管理

人员批量新增

POST
/v2/BaseInfo/BatchAddPersonByV3
BaseInfo
单次限制最多100笔人员信息、需要先调用/v2/BaseInfo/AddDepartment添加部门、可选(/v2/BaseInfo/GetUserRoleList查询角色编号、/v2/BaseInfo/GetIdentityList查询身份编号)

请求参数

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
请求示例请求示例
Shell
JavaScript
Java
Swift
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": {}
    }
  ]
}
上一页
人员新增
下一页
修改人员
Built with