学生点评记录查询(电子学生证设备号)

接口描述:

根据电子学生证设备号,查询学生点评记录及积分情况

接口地址:

  • https://api_server_url/v1/get/evaluate

请求方式:

  • GET

请求头:

  • Content-Type: application/json

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
accessToken 接口访问凭证 query true string
deviceNo 电子学生证设备号 query true string
lastSequence 上一次去数据后台返回给客户的Seq,默认为0 query false integer(int64)
limit 期望获取的数据量,0 < limit <= 100 ,默认为10 query false integer(int64)

响应状态

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

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

响应示例:

正确时返回:

{
    "code": 200,
    "status": "success",
    "message": "请求成功",
    "data": {
        "total": 1613.0,
        "increase": 1613.0,
        "decrease": 0.0,
        "records": [
            {
                "item": "体育",
                "amount": 1.00,
                "date": "2024-10-09",
                "dimension": "",
                "lastSequence": "1843952854329663488"
            },
            {
                "item": "德育",
                "amount": 1.00,
                "date": "2024-10-09",
                "dimension": "",
                "lastSequence": "1843952854329663488"
            },
            {
                "item": "加油可能是最29",
                "amount": 1.00,
                "date": "2024-10-09",
                "dimension": "",
                "lastSequence": "1843952854329663488"
            }
        ]
    }
}

错误时返回:

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

响应参数:

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

StudentEvaluationStateByEcardVO

参数名称 参数说明 类型 schema
total 学生当前学期内综合评价总积分数(积分卡币勋章总数) float
increase 学生当前学期内表扬所加的积分总数(积分卡币勋章总数) float
decrease 学生当前学期内批评所减的积分总数(积分卡币勋章总数) float
records 学生当前学期内综合评价点评记录,默认第一页数据 list List«PjEvaluationResultForECardVO»

PjEvaluationResultForECardVO

参数名称 参数说明 类型 schema
item 点评项名称 string
amount 点评项加/减分数 decimal
date 点评日期,格式:yyyy-MM-dd string
dimension 维度名称 string
lastSequence 批数据最后一条点评记录的ID integer(int64)

调用示例:

NodeJs - Axios:

var axios = require('axios');

var config = {
  method: 'get',
  url: 'https://api_server_url/v1/get/evaluate?accessToken=AT-10-R6Bl-dFf8itd6BM-pdSMzKRTR-kTmlpO&lastSequence=0&limit=100',
  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/v1/get/evaluate?accessToken=AT-10-R6Bl-dFf8itd6BM-pdSMzKRTR-kTmlpO&lastSequence=0&limit=100")
  .method("GET", null)
  .addHeader("X-App-Id", "1")
  .build();
Response response = client.newCall(request).execute();
作者:杭州天音  创建时间:2024-10-10 11:39
最后编辑:杭州天音  更新时间:2025-08-22 15:44