/api/login
登录。
接口原型
协议 |
HTTP/HTTPS POST |
URL |
ip[:port]/api/login |
数据格式 |
请求消息:Content-Type: application/json 响应消息:Content-Type: application/json |
Request Body
参数 |
描述 |
id |
用户名 |
pass |
MD5处理后的密码 |
请求示例
POST /api/login HTTP/1.1
Accept: application/json, text/plain, */*
Content-Type: application/json;charset=utf-8
Content-Length: xx
{
"id":"test",
"pass":"c4ca4238a0b923820dcc509a6f75849b"
}
响应参数
参数 |
描述 |
Content-Type |
取值为:'application/json; charset=UTF-8' |
Response Body
参数 |
描述 |
result |
返回码 |
is-hardware |
是否是硬件版本 |
token |
mwcloud-sid指向的键值 |
user |
用户信息 |
用户信息
参数 |
描述 |
name |
用户名 |
id |
用户id |
group-name |
分组名 |
permission |
权限掩码 |
type |
分组类型,1为admin,2为usr,4为viewer,8为自定义 |
可能返回的错误码
错误码 |
描述 |
MW_STATUS_NOT_EXIST |
用户不存在 |
MW_STATUS_MISMATCH |
密码错误 |
响应示例
HTTP/1.1 200 OK
content-type: application/json; charset=utf-8
content-length: xx
{
"is-hardware": false,
"result": 0,
"token": "xxxx",
"user": {
"group-name": "Admin",
"id": 1,
"name": "Admin",
"permission": 4294967295,
"type": 1
}
}