GET /api/users

请求

项	内容
方法	GET
路径	/api/users
鉴权	管理员

Header 参数

参数	位置	类型	必填	说明
Authorization	Header	string	是	Bearer <jwt>。
Content-Type	Header	string	否	无请求体时不需要。

Path 参数

无。

Query 参数

参数	位置	类型	必填	说明
page	Query	number	否	请求字段。
page_size	Query	number	否	请求字段。
search	Query	string	否	请求字段。

Body 参数

无。

返回值

用户列表。

返回字段

字段	类型	说明
id	number	用户 ID。
username	string	用户名。
email	string	邮箱。
oidc_sub	string/null	OIDC 用户标识。
email_verified	boolean	邮箱是否验证。
avatar_url	string	头像 URL。
balance	string/number	余额。
group_id	number	主用户组 ID。
group	object	主用户组。
groups	array	用户组成员关系，元素包含 id、user_id、group_id、group、expires_at、created_at、updated_at。
referral_code	string/null	邀请码。
referrer_id	number/null	邀请人 ID。
referrer	object/null	邀请人用户对象。
is_admin	boolean	是否管理员。
created_at	string	创建时间。
updated_at	string	更新时间。

错误

状态码	说明
400	参数不合法。
401	未登录或登录失效。
403	无权限。
404	资源不存在。
500	服务端错误。