查询学年和学期

接口说明

请求URL：http[s]😕/{网关地址}/casp-cal/schoolCal/v2/getYearAndTerm

请求方式： POST

请求内容类型： application/json

响应内容类型： application/json

请求说明

请求头

字段名	参数名	必填	类型	描述
应用ID	appId	M	String(128)	接入网关的应用ID
Token	accessToken	M	String	接入网关的accessToken

请求体

字段名	参数名	必填	类型
校历代码	yearCode	O	String
学年	academicYear	O	String
学期编码	termCode	O	String
用户账号	userAccount	M	String

请求示例

{
	"userAccount":"ampadmin",
	"yearCode":"2025",
	"termCode":"first",
	"academicYear":"2025"
}

响应说明

响应体

字段名	参数名	类型	描述
返回码	errcode	String	0 成功，其他为不成功
返回码描述	errmsg	String	返回码描述
数据	data	List<YearAndTermDto>

YearAndTermDto

字段名	参数名	类型	描述
学年代码	calendarCode	String	0 成功，其他为不成功
校历名称	calendarName	String	返回码描述
校区	campus	string
学年开始时间	calendarStartDate	string	yyyy-MM-dd HH:mm:ss
学年结束时间	calendarEndDate	string	yyyy-MM-dd HH:mm:ss
描述	yearDesc	string	富文本
学生类别	stuTypeList	List<Integer>	1本科生 2 研究生 3专科生
学期	terms	List<TermDto>	学期

TermDto

字段名	参数名	类型	描述
学期代码	termCode	String
学期	termNum	Int
学期开始时间	termStartDate	String	yyyy-MM-dd HH:mm:ss
学期结束时间	termEndDate	String	yyyy-MM-dd HH:mm:ss
学期描述	termDesc	String	富文本

响应示例

{
    "errcode": "0",
    "errmsg": "success",
    "data": [
        {
            "calendarCode": "2025",
            "calendarName": "2025学年xxxxxxxx",
            "academicYear": "2025",
            "campus": "金智校区xxxxxxx",
            "calendarStartDate": "2025-01-02 00:00:00",
            "calendarEndDate": "2025-06-17 23:59:59",
            "yearDesc": "描述xxxxx",
            "stuTypeList": [
                1
            ],
            "terms": [
                {
                    "termCode": "first",
                    "termNum": 3,
                    "termStartDate": "2025-01-02 00:00:00",
                    "termEndDate": "2025-06-16 23:59:59",
                    "termDesc": "学期描述"
                }
            ]
        }
    ],
    "traceId": "1382398239872184320",
    "subErrorCode": "0",
    "subErrorMsg": null
}

错误码

错误码	描述
999	统一错误码，详细描述信息参见接口返回

demo