Authorization 头携带访问令牌。Authorization: Bearer {access_token}access_token 和用户信息Authorization: Bearer {access_token}POST /admin/auth/login| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
username | string | 是 | 用户名 |
password | string | 是 | 密码 |
200 OK):| 字段 | 类型 | 说明 |
|---|---|---|
access_token | string | 访问令牌 |
token_type | string | 令牌类型,固定为 Bearer |
expires_in | integer | 令牌有效期(秒) |
user | object | 当前用户信息(LoginInfo 模型) |
{
"access_token": "1|abcdefghijklmnopqrstuvwxyz",
"token_type": "Bearer",
"expires_in": 7200,
"user": {
"user_id": 1,
"user_name": "admin",
"email": "admin@example.com",
"avatar": "https://example.com/avatar.jpg",
"roles": ["超级管理员"],
"buttons": ["admin.*"]
}
}401 Unauthorized:{
"message": "登录已过期,请重新登录"
}POST /admin/auth/logout204 No Content,无响应体。GET /admin/auth/info| 字段 | 类型 | 说明 |
|---|---|---|
user_id | integer | 用户 ID |
user_name | string | 用户名 |
email | string | 邮箱 |
avatar | string | 头像地址 |
roles | string[] | 角色名称列表 |
buttons | string[] | 按钮权限标识列表 |
admin.user.create、admin.role.deletepermission:权限标识 中间件进行控制。403 Forbidden:{
"message": "This action is unauthorized."
}| 状态码 | 场景 | 说明 |
|---|---|---|
401 | 未提供令牌 | 请求缺少 Authorization 头 |
401 | 令牌无效 | 令牌格式错误或不存在 |
401 | 令牌已过期 | 令牌超过有效期 |
403 | 权限不足 | 当前用户无该接口访问权限 |
422 | 验证失 败 | 用户名或密码格式不正确 |