查询学生主文化课程成绩数据

接口描述：

  • 查询学生主文化课程成绩数据，有些年级模板没有考试字段或者录入的成绩不是原始成绩数值则会返回空。

接口地址:

请求方式：

  • POST

请求头：

参数名称 参数说明 请求类型 是否必须 数据类型
X-App-Id 客户端 clientId header true string

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型
schoolYear 学年(格式为2024-2025) Body true String
term 学期(格式为01，数据范围为01、02，01表示上学期，02表示下学期) Body true String
gradeCode 年级代码(国标码，格式为11，数据范围为11-16) Body true String

请求示例

{
    "schoolYear":"2023-2024",
    "term":"02",
    "gradeCode":"16"
}

响应状态

状态码 说明
200 OK

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

响应示例:

正确时返回:

{
    "code": 200,
    "status": "success",
    "message": "请求成功",
    "data": [
        {
            "studentCode": "123456",
            "studentName": "小明",
            "classCode": "123",
            "className": "六年级(8)班",
            "subjectName": "语文",
            "examName": "期末综合",
            "score": "69",
            "createTime": "2024-06-24 10:16:07"
        }
    ]
}
字段 说明 类型
studentCode 学号 String
studentName 学生姓名 String
classCode 班级代码 String
className 班级名称 String
subjectName 科目名称 String
examName 考试名称 String
score 成绩 String
createTime 创建时间 String

错误时返回:

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

响应参数:

参数名称 参数说明 类型 schema
code 成功或异常编码 integer(int32) integer(int32)
data 成功或异常数据 array
message 成功或异常消息 string
status 旧接口成功、失败或异常辅助判断标记:success、fail、error,可用值:success,fail,error string
作者：杭州天音  创建时间：2024-09-29 16:14
最后编辑：杭州天音  更新时间：2025-08-22 15:44