一、基本信息
接口名称:获取某次考试学生成绩接口
接口说明:获取某次考试的学生各科成绩
接口地址:${BASEURL}/dataconnectorserv/integration/score/getStudentScores
请求方式:POST
请求类型:application/json
接口频率:接口调用上限500次/天
接口版本:1.0
修改日期:2026-02-27
小提示
如有理综,文综等综合课程,学生成绩只返回综合课程总分数,不返回具体课程(物理,化学,生物)分数,具体课程科目分数需要通过小题分进行计算。
二、请求参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| appKey | String | 是 | 平台提供的唯一标识 |
| schoolID | String | 是 | 学校ID,从学校列表获取 |
| examID | Long | 是 | 考试ID,从考试列表获取 |
{
"appKey": "36s2zllw",
"schoolID": "wca5opSRt2tyyBSLqOjdoS==",
"examID": 10086
}
三、响应结果
| 响应参数名称 | 响应参数类型 | 是否有值 | 说明 |
|---|---|---|---|
| stuScores | Array[Object] | 是 | 试卷列表 |
| studentEID | String | 是 | 学生EID |
| studentName | String | 是 | 学生姓名 |
| scores | Array[Object] | 是 | 成绩列表 |
| subjectID | String | 是 | 科目ID |
| subjectName | String | 是 | 科目名称 |
| score | Double | 是 | 考试得分 |
| fullScore | Double | 是 | 考试满分 |
| status | Int | 是 | 参考状态:0非缺考,1缺考 |
{
"code": 0,
"status": "success",
"result": {
"stuScores": [
{
"studentEID": "20180799",
"studentName": "张小五",
"scores": [
{
"subjectID": "8",
"subjectName": "数学",
"score": 100,
"fullScore": 150,
"status": 0
},
{
"subjectID": "9",
"subjectName": "语文",
"score": 0,
"fullScore": 150,
"status": 1
}
]
},
{
"studentEID": "20180792",
"studentName": "张小六",
"scores": [
{
"subjectID": "8",
"subjectName": "数学",
"score": 100,
"fullScore": 150,
"status": 0
},
{
"subjectID": "9",
"subjectName": "语文",
"score": 100,
"fullScore": 150,
"status": 0
}
]
}
]
}
}