CaμsAPI 接口定义

11. 学生教学日历获取

功能介绍:

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

接口: /schedule/{username}/{week}

接口说明:week为[1, 18]的正整数,代表 1-18 教学周

请求类型:POST

请求参数:

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

返回结果:

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

{
    "message": "Success",
    "username": "Request username",
    "weekschedule": [
      {
        "place": "class place",
        "type": "上课/考试",
        "starttime": "HH:MM",
        "duetime": "HH:MM",
        "date": "YYYY-MM-DD",
        "content": "class name"
      },
    ]
}

参数说明:

字段 含义 备注
type 活动类型 值为"上课"或者"考试"
starttime 开始时间 为"HH:MM" 格式字符串,注意HH开始的0可能被省略

参数示例:

  • 学生教学日历获取成功
Response 200

{
    "username": "mzj14",
    "message": "Success",
    "schedule": {
        "week": 17,
        "weekschedule": [
            {
                "place": "一教 104",
                "type": "考试",
                "starttime": "2:30",
                "duetime": "4:30",
                "date": "2017-01-04",
                "content": "计算机与网络体系结构(1)"
            }
        ]
    }
}
  • 学生教学日历获取失败 (即username非法)
Response 400

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

results matching ""

    No results matching ""