用户登录
1.接口描述
接口说明:用户登录。登录成功后会在 Cookie 存放 Session ID (Cookie: sid-[serial number]=t2i704wbvoy51y408p588bpji010ibp0)。
请求方式:POST [ip]/api/user/login
| 管理员权限 | 登录认证 |
|---|---|
| 否 | 否 |
2.输入参数
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| username | 是 | String | 用户名。此参数可通过获取系统用户列表获得。 |
| password | 是 | String | 密码,密码明文的 sha256 哈希值。 |
3.输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| status | Int | 状态码 |
| code | String | 状态描述 |
| sid | String | 用户标识 |
4.示例
使用正确的用户名和密码登录
输入示例
{
"username":"test",
"password":"c4ca4238a0b923820dcc509a6f75849b"
}
输出示例
Response Headers
Content-Type: application/json; charset=utf-8
Expires: 0
Set-Cookie: sid-A506220808450=6440wa6u5wfw8wv43f91v55cqkctnpv6
Response Body
{
"status": 0,
"code": "Success",
"sid": "6440wa6u5wfw8wv43f91v55cqkctnpv6"
}
5.错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
| 错误码 | 定义 | 说明 |
|---|---|---|
| 7 | MW_STATUS_INVALID_ARG | 参数缺失 |
| 16 | MW_STATUS_NOT_EXIST | 用户不存在 |
| 36 | MW_STATUS_AUTH_FAILED | 密码错误 |