一、基本信息

---

接口名称：获取学生成绩信息

接口说明：获取某个年级当前最近一次学生考试成绩

请求地址：${BASEURL}/dataconnectorserv/integration/score/getStuScores

请求方式：POST

请求类型：application/json

接口频率：接口调用上限500次/天

接口版本：3.0

修改日期：2023-12-05

二、请求参数

---

参数名	类型	是否必填	说明
appKey	String	是	平台提供的唯一标识
schoolID	String	是	学校ID，从学校列表获取
gradeID	String	是	年级ID，从年级列表获取

{
    "appKey": "36s2zllw",
    "schoolID": "wca5opSRt2tyyBSLqOjdoS==",
    "gradeID":"1012023"
}

三、响应结果

---

响应参数名称	响应参数类型	是否有值	说明
stuScoreInfos	Array	是	学生成绩信息列表
gradeID	String	是	年级ID
examID	Long	是	考试ID
examName	String	是	考试名称，最近一次考试
examType	String	是	考试类型（非实际考试/期中考试/期末考试/月考/区域联考）
examDate	String	是	考试时间，时间戳，单位为ms
examSubject	Array	是	考试科目列表
subjectID	String	是	科目ID
subjectName	String	是	科目名称
fullScore	Int	是	分制
category	Int	是	科目类型：普通考0，等级考1，合格考2
categoryName	String	是	科目类型名称
stuScores	Array	是	学生成绩列表
studentEID	String	否	学生ID，EID可切换1.平台ID，2.登录名，3.第三方厂商ID
studentName	String	否	学生姓名
qualifiedClassID	String	否	全校唯一ID
scores	Array	是	学生分数列表
subjectID	String	否	科目ID
category	Int	否	科目类型：普通考0，等级考1，合格考2
score	Double	否	分数

{
    "code": 0,
    "status": "success",
    "result": {
        "stuScoreInfos": [
            {
                "gradeID": "1012020",
                "examID": 10086,
                "examName": "第五次月考",
                "examType": "月考",
                "examDate": 1603814400000,
                "examSubject": [
                    {"subjectID": "9","subjectName": "数学","fullScore": 150,"category": 0,"categoryName": "普通"},
                    {"subjectID": "1","subjectName": "物理","fullScore": 100,"category": 0,"categoryName": "普通"},
                    {"subjectID": "2","subjectName": "化学","fullScore": 100,"category": 2,"categoryName": "合格考"}
                ],
                "stuScores": [
                    {
                        "studentEID": "20180799",
                        "studentName": "孟庆涵",
                        "qualifiedClassID": "1012020-1",
                        "scores": [
                            {"subjectID": "8","category": 0,"score": 60},
                            {"subjectID": "9","category": 0,"score": 84},
                            {"subjectID": "2","category": 1,"score": 59}
                        ]
                    },
                    {
                        "studentEID": "20180792",
                        "studentName": "张小五",
                        "qualifiedClassID": "1012020-1",
                        "scores": [
                            {"subjectID": "8","category": 0,"score": 62},
                            {"subjectID": "9","category": 0,"score": 62},
                            {"subjectID": "2","category": 1,"score": 62}
                        ]
                    }
                ]
            }
        ]
    }
}