登录/注册接口
登录接口
接口描述
通过账号密码获取用户登录数据。
请求说明
请求方式：POST
请求URL ：[/v1/user/login]
请求参数
| 字段 | 字段类型 | 必选 | 字段说明 |
|---|---|---|---|
| account | string | 是 | 用户名 |
| password | string | 是 | 密码 |
返回结果
{
"code": 1,
"msg": "登录成功",
"time": "1603373532",
"data": {
"userinfo": {
"group_id": 1,
"username": "admin",
"nickname": "admin",
"mobile": "13888888888",
"avatar": "data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZlcnNpb249IjEuMSIgaGVpZ2h0PSIxMDAiIHdpZHRoPSIxMDAiPjxyZWN0IGZpbGw9InJnYigxNjAsMTkwLDIyOSkiIHg9IjAiIHk9IjAiIHdpZHRoPSIxMDAiIGhlaWdodD0iMTAwIj48L3JlY3Q+PHRleHQgeD0iNTAiIHk9IjUwIiBmb250LXNpemU9IjUwIiB0ZXh0LWNvcHk9ImZhc3QiIGZpbGw9IiNmZmZmZmYiIHRleHQtYW5jaG9yPSJtaWRkbGUiIHRleHQtcmlnaHRzPSJhZG1pbiIgYWxpZ25tZW50LWJhc2VsaW5lPSJjZW50cmFsIj5BPC90ZXh0Pjwvc3ZnPg==",
"token": "e63d14b9-51d9-49be-bf37-e23c982a1a42",
"user_id": 1,
"createtime": 1603373532,
"expiretime": 1605965532,
"expires_in": 2592000
}
}
}数据说明
| 字段 | 字段说明 |
|---|---|
| user_id | 用户唯一标识 |
| group_id | 用户分组ID（待用） |
| username | 用户名 |
| nickname | 昵称 |
| mobile | 手机号 |
| avatar | 头像地址 |
| token | token，用于接口调用的令牌 |
| createtime | 用户创建账号时间 |
| expiretime | token过期时间 |
| expires_in | token有效期（秒） |
注册接口
接口描述
注册平台账号。
请求说明
请求方式：POST
请求URL ：[/v1/user/register]
请求参数
| 字段 | 字段类型 | 必选 | 字段说明 |
|---|---|---|---|
| username | string | 是 | 用户名 |
| password | string | 是 | 密码 |
| string | 是 | 邮箱 | |
| mobile | int | 是 | 手机号 |
返回结果
{
"code": 1,
"msg": "注册成功",
"time": "1603374833",
"data": {
"userinfo": {
"group_id": 0,
"username": "test",
"nickname": "test",
"mobile": "13775564663",
"avatar": "data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZlcnNpb249IjEuMSIgaGVpZ2h0PSIxMDAiIHdpZHRoPSIxMDAiPjxyZWN0IGZpbGw9InJnYigyMjksMjAxLDE2MCkiIHg9IjAiIHk9IjAiIHdpZHRoPSIxMDAiIGhlaWdodD0iMTAwIj48L3JlY3Q+PHRleHQgeD0iNTAiIHk9IjUwIiBmb250LXNpemU9IjUwIiB0ZXh0LWNvcHk9ImZhc3QiIGZpbGw9IiNmZmZmZmYiIHRleHQtYW5jaG9yPSJtaWRkbGUiIHRleHQtcmlnaHRzPSJhZG1pbiIgYWxpZ25tZW50LWJhc2VsaW5lPSJjZW50cmFsIj5UPC90ZXh0Pjwvc3ZnPg==",
"token": "95a33a9b-a71c-4eb6-a354-92b183445bc8",
"user_id": 2,
"createtime": 1603374833,
"expiretime": 1605966833,
"expires_in": 2592000
}
}
}数据说明
| 字段 | 字段说明 |
|---|---|
| user_id | 用户唯一标识 |
| group_id | 用户分组ID（待用） |
| username | 用户名 |
| nickname | 昵称 |
| mobile | 手机号 |
| avatar | 头像地址 |
| token | token，用于接口调用的令牌 |
| createtime | 用户创建账号时间 |
| expiretime | token过期时间 |
| expires_in | token有效期（秒） |
重置密码接口
接口描述
当用户忘记密码时，可以通过注册的手机号进行重置密码。
请求说明
请求方式：POST
请求URL ：[/v1/user/resetpwd]
请求参数
| 字段 | 字段类型 | 必选 | 字段说明 |
|---|---|---|---|
| mobile | int | 是 | 手机号 |
| newpassword | string | 是 | 密码（不能低于6个字符） |
返回结果
{
"code": 1,
"msg": "重置密码成功",
"time": "1603377760",
"data": null
}token检测接口
接口描述
检测token是否过期。
请求说明
请求方式：GET
请求URL ：[/v1/token/check]
请求参数
| 字段 | 字段类型 | 必选 | 字段说明 |
|---|---|---|---|
| token | string | 是 | token值 |
返回结果
{
"code": 1,
"msg": "",
"time": "1603376843",
"data": {
"token": "dd44991f-db63-4980-a8e0-2202a793f69f",
"expires_in": 2591979
}
}数据说明
| 字段 | 字段说明 |
|---|---|
| token | token值 |
| expires_in | token有效期（秒） |
token检测接口
接口描述
检测token是否过期。
请求说明
请求方式：GET
请求URL ：[/v1/token/refresh]
请求参数
| 字段 | 字段类型 | 必选 | 字段说明 |
|---|---|---|---|
| token | string | 是 | token值 |
返回结果
{
"code": 1,
"msg": "",
"time": "1603376822",
"data": {
"token": "dd44991f-db63-4980-a8e0-2202a793f69f",
"expires_in": 2592000
}
}数据说明
| 字段 | 字段说明 |
|---|---|
| token | token值 |
| expires_in | token有效期（秒） |