Skip to main content

一、基本信息​

接口名称：获取全部年级信息接口

接口说明：当前学校所有年级信息列表

请求地址：${BASEURL}/dataconnectorserv/integration/basic/getGrades

请求方式：POST

请求类型：application/json

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

接口版本：3.0

修改日期：2023-12-05

二、请求参数​

参数名类型是否必填说明
appKeyString是平台提供的唯一标识
schoolIDString是学校ID，从学校列表获取
{
    "appKey": "36s2zllw",
    "schoolID": "wca5opSRt2tyyBSLqOjdoS=="
}

三、响应结果​

响应参数名称响应参数类型是否有值说明
gradesArray是年级列表
gradeEntrYearString是入学年份
eduSystemInt是学校学制，例如：小学6年，初中3年，高中3年
eduStageString是学校学段：幼儿园，小学，初中，高中，大学
gradeIDString是学校年级唯一ID
gradeCodeInt是年级编码 k15，查看字典年级对照表
gradeNameString是年级名称
gradeAdminsArray是年级管理员
teacherEIDString否教师EID
teacherNameString否教师姓名
{
    "code": 0,
    "status": "success",
    "result": {
        "grades": [
            {
                "gradeEntrYear": "2023",
                "eduSystem": 3,
                "eduStage": "初中",
                "gradeCode": 23,
                "gradeStatus": 1,
                "gradeID": "2012023",
                "gradeName": "初一",
                "gradeAdmins": [
                    {
                        "teacherEID": "17674143474",
                        "teacherName": "黄老师"
                    },
                    {
                        "teacherEID": "17608467922",
                        "teacherName": "黄泓源"
                    }
                ]
            },
            {
                "gradeEntrYear": "2023",
                "eduSystem": 3,
                "eduStage": "高中",
                "gradeCode": 31,
                "gradeStatus": 1,
                "gradeID": "1012023",
                "gradeName": "高一",
                "gradeAdmins": []
            }
        ]
    }
}