批量获取学校下的教职工基本信息

接口信息

  • 接口地址: https://api_server_url/teacher/list
  • 请求方式: GET
  • 接口描述: 根据学校的组织机构ID批量获取学校下的教职工基本信息

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
accessToken 接口访问凭证 query true string
lastSequence 上一次去数据后台返回给客户的Seq，默认为0 query false integer(int64)
limit 期望获取的数据量，0 < limit <= 1000，默认为1000 query false integer(int64)
orgId 学校的组织机构id query true integer(int64)

响应状态

状态码 说明 schema
200 OK ApiRestResponse«List«JzgVO»»

其他状态码参见：全局状态码

响应示例:

正确时返回:

{
    "code": 200,
    "status": "success",
    "message": "请求成功",
    "data": [
        {
            "id": "230822197804127848",
            "userId": "1524598471955935676",
            "gh": "zyl127848",
            "xm": "张**",
            "xbm": "2",
            "xbmc": "女",
            "dqztm": "100",
            "dqztmc": "在本单位任职",
            "jzglb": "328",
            "jzglbmc": "专任教师",
            "lastSequence": 0
        }
    ]
}

错误时返回:

{
    "code": 500,
    "data": {},
    "message": "成功或异常消息",
    "status": "fail"
}

响应参数:

参数名称 参数说明 类型 schema
code 成功或异常编码 integer(int32) integer(int32)
data 成功或异常数据 array JzgVO
message 成功或异常消息 string
status 旧接口成功、失败或异常辅助判断标记:success、fail、error,可用值:success,fail,error string

Schema 属性:

JzgVO

参数名称 参数说明 类型 schema
id 教职工基本数据子类表ID integer(int64)
userId 学生的用户ID integer(int64)
dqztm 当前状态码 string
dqztmc 当前状态名称 string
gh 工号 string
jzglb 教职工类别 string
jzglbmc 教职工类别名称 string
xbm 性别码 string
xbmc 性别名称 string
xm 姓名 string
lastSequence 上一次去数据后台返回给客户的Seq，初次拉取时为0 integer(int64)

调用示例:

NodeJs - Axios：

var axios = require('axios');

var config = {
  method: 'get',
  url: 'https://api_server_url/teacher/list?accessToken=AT-16-1A-LDky-DrnnXdWh68L5wD3y2xkioxGM&lastSequence=0&limit=1&orgId=207',
  headers: {
    'X-App-Id': '1'
  }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

Java - OkHttp 示例：

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
Request request = new Request.Builder()
  .url("https://api_server_url/teacher/list?accessToken=AT-16-1A-LDky-DrnnXdWh68L5wD3y2xkioxGM&lastSequence=0&limit=1&orgId=207")
  .method("GET", null)
  .addHeader("X-App-Id", "1")
  .build();
Response response = client.newCall(request).execute();
作者：杭州天音  创建时间：2022-07-27 18:08
最后编辑：杭州天音  更新时间：2025-08-22 15:44