CaμsAPI 接口定义

7. 学生学期课表获取

功能介绍:

  • 开发者通过此 API 获取学生本学期的课表信息

接口: /curriculum/{username}

请求类型:POST

请求参数:

{
    "apikey": "API Key",
    "apisecret": "API Secret Key"
}

返回结果:

  • 学生学期课表获取成功
Response 200

{
    "message": "Success",
    "username": "Request username",
    "classes": [
        {
            "coursename": "Course name",
            "courseid": "a semantic identifier for courses",
            "time": [day, period],
            "teacher": "Teacher",
            "classroom": "Classroom",
            "week": array of 0/1 whose length equals 16
        }
    ]

}

参数说明:

字段 含义 备注
day 周一~周日 1~7,代表周一~周日
period 第一大节~第六大节 1~6, 代表第一大节~第六大节
week 课程周数分布 值为字符串类型的长度为16的数组,元素为 0 或 1,表示某一周是否有此课

参数示例:

Response 200

{
    "message": "Success",
    "username": "mzj14",
    "classes": [
        {
            "courseid": "2016-2017-1-34100294-0",
            "coursename": "计算机与网络体系结构(1)",
            "time": [3,2],
            "teacher": "刘云浩",
            "classroom": "六教6A209",
            "week": [1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]
        },
        {
            "courseid": "2016-2017-1-34100294-0",
            "coursename": "计算机与网络体系结构(1)",
            "time": [3,2],
            "teacher": "刘云浩",
            "classroom": "六教6A209",
            "week": [1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]
        }
    ]
}
  • 学生学期课表获取失败 (即username非法)
Response 400

{
    "message": "Failure",
    "username": "Request username",
    "reason": "Invalid username"
}

results matching ""

    No results matching ""