学期信息

当前版本：

    version= V1.0

接口功能：

    用于分页获取RunLan平台学期信息。

接口地址：

    /api/v1/term/queryTerms

请求方式：

POST

请求参数：

Body

参数名称	是否必选	参数类型	说明/示例
selType	是	Int	查询类型 0:分页查询,1:列表查询
pageSize	条件必选（当selType=0时必选，下同）	Int	查询条数(建议设置为1~300)
page	条件必选	Int	当前页数(从1开始)
termID	否	String	学期ID
termName	否	String	学期名称
termType	否	int	学期类型(0第二学期 1第一学期)
startYear	否	String	开始学年
endYear	否	String	结束学年
startTime	否	String	开始时间(格式:yyyy-MM-dd)
endTime	否	String	结束时间(格式:yyyy-MM-dd)

说明：为了保证系统的效率，建议每次取数据最多不超过300条数据。

返回值说明

返回值字段	类型	说明
msg	String	提示信息
code	String	0失败,1成功
data	Object	学期信息分页结果集(数据为空时为:data:[])

result结果集返回值字段说明

返回值字段	类型	说明
total	Int	总条数
current	Int	当前页
size	Int	每页条数
rows	Array	当前分页学期信息数据集
data	Object	学期信息
termID	String	学期ID（非空）
termName	String	学期名称
startYear	String	开始学年
endYear	String	结束学年
startTime	String	开始日期，格式：yyyy-MM-dd
endTime	String	结束日期，格式：yyyy-MM-dd
remark	String	备注
termType	Int	学期类型：1第一学期0第二学期

返回结果示例(JSON)

• 返回成功

• 分页查询
  

{
    "success": true,

    "code": 200,

    "msg": "成功",

    "data": {

        "total": 20,

        "current": 1,

        "size": 2,

        "rows": [

            {

                "termID": "0845dbe4-281a-4aa1-88c2-2c73a3c8f732",

                "startYear": "2021",

                "endYear": "2022",

                "termType": 0,

                "startTime": "2022-02-07",

                "endTime": "2022-06-25",

                "remark": "",

                "termName": "2021~2022【第二学期】"

            },

            {

                "termID": "1f61465a-d4f8-4541-93f6-e4fd98687198",

                "startYear": "2024",

                "endYear": "2025",

                "termType": 1,

                "startTime": "2024-08-12",

                "endTime": "2025-02-12",

                "remark": "",

                "termName": "2024~2025【第一学期】"

            }

        ]

    }

}

• 列表查询

{

    "success": true,

    "code": 200,

    "msg": "成功",

    "data": [

        {

            "termID": "f3b515d3-3b86-4e3a-8540-e19fc6febc31",

            "startYear": "2015",

            "endYear": "2016",

            "termType": 0,

            "startTime": "2016-01-31",

            "endTime": "2016-06-30",

            "remark": "",

            "termName": "2015~2016【第二学期】"

        },

        {

            "termID": "823bf506-8bbe-4a05-9d08-2e79e1468bc0",

            "startYear": "2016",

            "endYear": "2017",

            "termType": 0,

            "startTime": "2017-03-01",

            "endTime": "2017-07-01",

            "remark": "",

            "termName": "2016~2017【第二学期】"

        }

    ]

}

• 返回失败

  {

    "msg":"具体错误原因",

    "code":-999

  }

版本变更说明：

    无