Files

T

guke a563c1ca4b @ (#111 )

docs/api目录文档分类和补全

---------

Co-authored-by: guke <guke@autohome.com.cn>
Reviewed-on: #111

2026-07-03 15:00:37 +08:00

GET /admin/api/admins — 管理员列表

所属:Admin·Accounts 组（前缀 /admin/api/admins） | 鉴权:Bearer admin_token（角色:super_admin） | ← 返回 API 索引

入参

无（按 id 升序返回全部,无分页）

响应 200:AdminOut[]

AdminOut

字段	类型	说明
`id`	int	管理员 id
`username`	string	账号
`role`	string	角色:`super_admin` / `finance` / `operator`
`status`	string	状态:`active` / `disabled`
`created_at`	datetime	创建时间(UTC)
`last_login_at`	datetime \| null	上次登录时间,从未登录为 null

401 未带 admin token / token 无效或过期 / 管理员被禁用
403 角色不足(仅 super_admin 可访问,detail 形如 role 'operator' not allowed (need one of [...]))

账号管理整组(/admin/api/admins)的角色守卫为 require_role() 无参,即仅 super_admin 通过。数据表见 admin_user。