教职工信息

当前版本:

    version= V1.0

接口功能:

    用于分页获取RunLan平台教职工基本信息。

接口地址:

    /api/v1/teacher/queryTeachers

请求方式:

POST

请求参数:

Body

参数名称是否必选参数类型说明/示例
selTypeInt查询类型 0:分页查询,1:列表查询
pageSize条件必选(当selType=0时必选,下同)Int查询条数(建议设置为1~300)
page条件必选Int当前页数(从1开始)
nameString姓名/身份证号/教师工号
teacherIDString教师ID
teacherSexint教师性别:0女1男
departmentIDString部门ID
timestampString变化数据的开始时间戳 13位/ms

说明:为了保证系统的效率,建议每次取数据最多不超过300条数据。

返回值说明

返回值字段类型说明
msgString提示信息
codeInt200成功,其它失败
dataObject教师基本信息分页结果集(没有查到数据时为空列表data:[])

result结果集返回值字段说明

返回值字段类型说明
totalInt总条数
currentInt当前页
sizeInt每页条数
rowsArray当前分页教职工基础信息数据集
dataObject查询到的教职工数据(没有查到数据时为空列表data:[])
teacherIDString教职工ID(非空)
teacherNameString姓名
teacherSexint性别(1男/0女)
idCardNumberString身份证号码(非空)
teacherNumber  String 工号(有可能为空值,不建议作为主键)
departmentNameString所属部门名称
departmentIDString所属部门ID
phoneNumberString手机号码

返回结果示例(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

  }

版本变更说明:

    无