批量获取学校下的学生基本信息(带敏感信息)
接口描述:
根据学校的组织机构ID批量获取学校下的学生基本信息(带敏感信息)
接口地址:
https://api_server_url/student/listWithSensetiveInfo
请求方式:
- GET
请求参数:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | 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«StudentVO»» |
其他状态码参见:全局状态码
响应参数:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
code | 成功或异常编码 | integer(int32) | integer(int32) |
data | 成功或异常数据 | array | StudentVO |
message | 成功或异常消息 | string | |
status | 旧接口成功、失败或异常辅助判断标记:success、fail、error,可用值:success,fail,error | string |
Schema 属性:
StudentVO
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
id | 学生基本数据子类表ID | integer(int64) | |
userId | 学生的用户ID | integer(int64) | |
rxny | 入学年月 | string | |
sjzk | 生籍情况 | integer(int32) | |
sjzkmc | 生籍情况名称 | string | |
xbm | 性别码 | string | |
xbmc | 性别名称 | string | |
xh | 学号 | string | |
xjh | 学籍号 | string | |
xm | 姓名 | string | |
xsdqztm | 学生当前状态码 | string | |
xsdqztmc | 学生当前状态名称 | string | |
sensitiveInfo | 敏感信息 | object | |
sensitiveInfo.idCardNumber | 身份证号码 | string | |
lastSequence | 上一次去数据后台返回给客户的Seq,初次拉取时为0 | integer(int64) |
其他状态码参见:全局状态码
响应示例:
正确时返回:
{
"code": 200,
"status": "success",
"message": "请求成功",
"data": [
{
"id": "",
"userId": "",
"xm": "程**",
"xbm": "1",
"xbmc": "男",
"xh": "",
"xjh": "",
"rxny": "",
"xsdqztm": "4",
"xsdqztmc": "在校",
"sjzk": 0,
"sjzkmc": "有学籍无学生",
"lastSequence": 0,
"sensitiveInfo": {
"idCardNumber": "***************"
}
}
]
}
错误时返回:
{
"code": 500,
"data": {},
"message": "成功或异常消息",
"status": "fail"
}
调用示例:
NodeJs - Axios:
var axios = require('axios');
var config = {
method: 'get',
url: 'https://api_server_url/student/listWithSensetiveInfo?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/student/listWithSensetiveInfo?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();
作者:杭州天音 创建时间:2023-08-17 11:02
最后编辑:杭州天音 更新时间:2025-08-22 15:44
最后编辑:杭州天音 更新时间:2025-08-22 15:44