获取学生详细信息

接口描述:

根据学校组织ID + 学生ID 获取指定学生详细信息

接口地址:

  • https://api_server_url/student/info

请求方式:

  • GET

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
accessToken 接口访问凭证 query true string
orgId 学校的组织机构id query true integer(int64)
id 学生id query true Long

响应状态

状态码 说明 schema
200 OK ApiRestResponse«PhoneVO»

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

响应示例:

正确时返回:

{
    "code": 200,
    "status": "success",
    "message": "请求成功",
    "data": {
        "id": "",
        "userId": "",
        "xm": "程**",
        "xbm": "1",
        "xbmc": "男",
        "xh": "",
        "xjh": "",
        "lxdh": "",
        "csrq": "",
        "csdm": "",
        "gjdqm": "",
        "sfwjry": 0,
        "sfwjrymc": "否",
        "mzm": "",
        "mzmc": "",
        "rxny": "",
        "njsjzlbId": "3229",
        "njmc": "2021级中班",
        "bjmc": "",
        "xslbm": "",
        "xslbmc": "",
        "xsdqztm": "4",
        "xsdqztmc": "在校",
        "sjzk": "0",
        "sjzkmc": "有学籍无学生"
    }
}

错误时返回:

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

响应参数:

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

StudentInfoVO

参数名称 参数说明 类型 schema
id 学生基本数据子类表ID integer(int64)
userId 学生的用户ID integer(int64)
bjmc 班级名称 string
bjsjzlbId 班级ID integer(int64)
csdm 出生地码 string
csrq 出生日期 string
gjdqm 国籍/地区码 string
lxdh 联系电话 string
mzm 民族码 string
mzmc 民族名称 string
njmc 年级名称 string
njsjzlbId 年级ID integer(int64)
rxny 入学年月 string
sfwjry 是否外籍人员 integer(int32)
sfwjrymc 是否外籍人员名称 string
sjzk 生籍情况 string
sjzkmc 生籍情况名称 string
xbm 性别码 string
xbmc 性别名称 string
xh 学号 string
xjh 学籍号 string
xm 姓名 string
xsdqztm 学生当前状态码 string
xsdqztmc 学生当前状态名称 string
xslbm 学生类别码 string
xslbmc 学生类别名称 string

调用示例:

NodeJs - Axios:

var axios = require('axios');

var config = {
  method: 'get',
  url: 'https://api_server_url/student/info?accessToken=AT-17-IiZD3-NvsEhXj2Sz5D-Xqxpyd2z3kPI5&orgId=207&id=230822197804127848',
  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/info?accessToken=AT-17-IiZD3-NvsEhXj2Sz5D-Xqxpyd2z3kPI5&orgId=207&id=230822197804127848")
  .method("GET", null)
  .addHeader("X-App-Id", "1")
  .build();
Response response = client.newCall(request).execute();
作者:杭州天音  创建时间:2022-07-27 18:06
最后编辑:杭州天音  更新时间:2025-08-22 15:44