学生点评记录查询(电子学生证设备号)
接口描述:
根据电子学生证设备号,查询学生点评记录及积分情况
接口地址:
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
最后编辑:杭州天音 更新时间:2025-08-22 15:44