01. 登录

通过学号/录取通知书号、密码登录

使用 统一身份认证系统 的账号密码登录

Url

POST /api/user/login

Header

参数	类型	必需	描述	示例
Content-Type	string	是	application/json	application/json
Accept	string	是	application/json	application/json

Body

参数	类型	必需	描述
username	string	是	学号/录取通知书号
password	string	是	密码，不少于 6 个字符

{
    "username": "YOUR_STUDENT_NO",
    "password": "YOUR_PASSWORD"
}

Response

status: 200 OK

{
    "code": 201,
    "data": {
        "token": "EXAMPLE_TOKEN"
    },
    "time": "2018-02-14T14:40:50Z",
    "msg": "Post Success"
}

参数名	描述	类型
code	HTTP 响应码	Number
data.token	JWT 加密后的 token，明文部分包括学号、数据库 Object ID，原则上不在 Token 中传递敏感信息	String
time	请求处理完成的 UTC 时间戳	String
msg	响应附加信息	String

Note

1. 统一身份认证系统登录状态过期时间已不支持设置为 7 天，cookies 过期时间现已无法确定，在使用 API 时请自行处理 token 刷新机制，使用未过期的 token 获取课程等其他信息时，如果返回 403，请手动调用登录接口刷新 token 后重新获取，示例返回如下：

   {
       "code": 403,
       "data": "统一身份认证系统需要授权"
   }

2. token 有效期为 7 天，对于需要认证的请求，token 参数错误将会返回 401