获取认证
Zdir 3部分接口,比如上传、重命名、删除等操作需要获取认证Token后才能操作,部分公共API则无需认证,获取认证方法如下。
接口说明
- 请求地址:
/api/user/login
- 请求方法:POST
- 提交方式:
multipart/form-data
请求参数
参数名称 | 示例值 | 类型 | 是否必须 | 说明 |
---|---|---|---|---|
username | xiaoz | string(16) | 是 | 用户名 |
password | xiaoz.me | string(16) | 是 | 密码 |
请求成功响应
{
"code": 200,
"data": {
"UserName": "xxx",
"Cid": "JJjKWZ",
"Token": "5de13ebfb0xxxxxx861fbe"
},
"msg": "success"
}
-
code
:200代表成功,其它为失败 -
msg
:消息内容 -
data.UserName
:返回用户名 -
data.Cid
:返回的ClientID,后续认证需要 -
data.Token
:返回的Token值,后续认证需要
注意:Token认证有效期为7天,过期后请重新获取。
请求失败响应
{
"code": -1000,
"data": "",
"msg": "用户名或密码错误!"
}
请求认证
需要认证的接口需要携带header头部,以下为公共头部参数:
参数名称 | 示例值 | 类型 | 是否必须 | 说明 |
---|---|---|---|---|
X-Cid | JJjKWZ | string(6) | 是 | CID,对应data.Cid |
X-Token | 5de13ebfb0xxxxxx861fbe | string(32) | 是 | Toekn,对应data.Token |