当前版本:
version= V1.0
接口功能:
用于分页获取RunLan平台教职工基本信息。
接口地址:
/api/v1/teacher/queryTeachers
请求方式:
POST
请求参数:
Body
| 参数名称 | 是否必选 | 参数类型 | 说明/示例 |
|---|---|---|---|
| selType | 是 | Int | 查询类型 0:分页查询,1:列表查询 |
| pageSize | 条件必选(当selType=0时必选,下同) | Int | 查询条数(建议设置为1~300) |
| page | 条件必选 | Int | 当前页数(从1开始) |
| name | 否 | String | 姓名/身份证号/教师工号 |
| teacherID | 否 | String | 教师ID |
| teacherSex | 否 | int | 教师性别:0女1男 |
| departmentID | 否 | String | 部门ID |
| timestamp | 否 | String | 变化数据的开始时间戳 13位/ms |
说明:为了保证系统的效率,建议每次取数据最多不超过300条数据。
返回值说明
| 返回值字段 | 类型 | 说明 |
|---|---|---|
| msg | String | 提示信息 |
| code | Int | 200成功,其它失败 |
| data | Object | 教师基本信息分页结果集(没有查到数据时为空列表data:[]) |
result结果集返回值字段说明
| 返回值字段 | 类型 | 说明 |
|---|---|---|
| total | Int | 总条数 |
| current | Int | 当前页 |
| size | Int | 每页条数 |
| rows | Array | 当前分页教职工基础信息数据集 |
| data | Object | 查询到的教职工数据(没有查到数据时为空列表data:[]) |
| teacherID | String | 教职工ID(非空) |
| teacherName | String | 姓名 |
| teacherSex | int | 性别(1男/0女) |
| idCardNumber | String | 身份证号码(非空) |
| teacherNumber | String | 工号(有可能为空值,不建议作为主键) |
| departmentName | String | 所属部门名称 |
| departmentID | String | 所属部门ID |
| phoneNumber | String | 手机号码 |
返回结果示例(JSON)
返回成功
分页查询
{
"success": true,
"code": 200,
"msg": "成功",
"data": {
"total": 2,
"current": 1,
"size": 2,
"rows": [
{
"teacherid": "62453373-5031-7921-11BA-F90433910087",
"teachername": "陈东丽",
"teachersex": 0,
"idcarnumber": "340828198604102143",
"teachernumber": "D220703",
"departmentID": "3101FED4-B9FA-23BB-0FEF-5E8AC886B6FD",
"departmentname": "招就处",
"phonenumber": "13255605507"
},
{
"teacherid": "54F2B09B-6618-2878-DF97-CFADE514535C",
"teachername": "张成林",
"teachersex": 1,
"idcarnumber": "34082819960212401X",
"teachernumber": "D220313",
"departmentID": "5E0E318A-B3CD-EDB8-7EDE-7C58616FAE06",
"departmentname": "学生处",
"phonenumber": "19355678081"
}
]
}
}
或:
{
"success": true,"code": 200,
"msg": "Success",
"data": []
}
列表查询
{
"success": true,
"code": 200,
"msg": "成功",
"data": [
{
"teacherID": "76b01990-92d8-4b06-a8f7-42257c6d0fdd",
"teacherName": "test",
"teacherNumber": "",
"teacherSex": "1",
"phoneNumber": "13900000000",
"idCardNumber": "342422199009191116",
"departmentName": "无",
"departmentID": "32ad79db-ec35-4cea-a0ba-f87af1a30340"
},
{
"teacherID": "f8656dae-437b-42f5-88f2-c86432f2238c",
"teacherName": "丁健",
"teacherNumber": "",
"teacherSex": "1",
"phoneNumber": "15256933196",
"idCardNumber": "340102196809061531",
"departmentName": "安全保卫处",
"departmentID": "1e0dcaf1-91c1-4146-9d2f-6f93923b8b21"
}
]
}
返回失败
{
"msg":"具体错误原因",
"code":-999
}
版本变更说明:
无