文档
测试
POST
/user/login

请求参数

参数名
类型
描述
必填
username
String
用户ID
必填
password
String
明文密码,hash后与数据库里的进行比对
必填

正确时响应

参数名
类型
描述
必填
username
String
用户ID
必填
role
Int64
用户类型,101: 普通用户 102: 设备提供者 200: 平台管理者
必填
status
Int64
用户状态,100: 正常 200: 被封禁
必填

正确时响应头

参数名
类型
描述
必填
sessionId
Set-Cookie
会话ID,无过期时间
必填

错误时响应

参数名
类型
描述
必填
error
String
用户名为空字符串或用户名不存在:"no such a user" | 密码为空字符串或密码不匹配:"password is wrong"
必填

说明 / 示例

所有的跟作业四相同,唯一不同的是session: 1. 作业四是session_id(下划线命名法),这里是sessionId(骆驼命名法)。原因:保持API命名统一 2. 作业四:「如果当前已经处于登录状态,报错返回{"error": "has logged in"}」,这里:「如果当前已经处于登录状态,换新sessionId并在正确响应里携带新的sessionId」。原因:如此一来,不同两个地方登录时后一个会话的sessionId是正确的,前一个会话用旧的sessionId发请求会失败。 相同:sessionId无过期时间。