Admin · Users
User accounts, quotas and password resets (admins only)
全部用户及其用量，不分页。仅管理员。
sessionimgyoung_session<token>登录下发的会话 cookie；状态变更请求须另以 X-CSRF-Token 头回传会话绑定的 CSRF 令牌。
用户列表
application/json- response
items*array<>total*integerint64curl -X GET 'http://localhost:8721/api/admin/users'{ "items": [ { "id": "string", "name": "string", "role": "admin", "quota_bytes": 0, "default_ttl_hours": 0, "disabled": true, "created_at": "string", "used_bytes": 0, "image_count": 0 } ], "total": 0}密码至少 8 个字符；role 缺省为 user。仅管理员。
sessionimgyoung_session<token>登录下发的会话 cookie；状态变更请求须另以 X-CSRF-Token 头回传会话绑定的 CSRF 令牌。
X-CSRF-Token*string登录或 GET /api/admin/me 响应里的 csrf_token；缺失或不匹配返回 403
application/json- body
建号请求；未知字段整体拒绝
name*string登录名
password*string初始密码，至少 8 个字符
passwordrole?Role角色
"admin""user"quota_bytes?integer配额上限；缺省或不大于 0 表示不限
int64default_ttl_hours?|上传默认有效期（小时）；缺省或 null 随全局，0 永久
int640 <= value <= 876000已创建
application/json- response
用户列表项，不含任何凭证材料
id*stringname*string登录名
role*Role角色
"admin""user"quota_bytes*|配额上限；null 表示不限
int64default_ttl_hours*|上传默认有效期（小时）；null 随全局，0 永久
int64disabled*booleancreated_at*stringused_bytes*integer已用字节，按引用计全额
int64image_count*integerint64curl -X POST 'http://localhost:8721/api/admin/users' \ -H 'X-CSRF-Token: string' \ -H 'Content-Type: application/json' \ -d '{ "name": "string", "password": "pa$$word"}'{ "id": "string", "name": "string", "role": "admin", "quota_bytes": 0, "default_ttl_hours": 0, "disabled": true, "created_at": "string", "used_bytes": 0, "image_count": 0}名下仍有图片（409）、内置管理员（403）或当前登录用户（400）拒绝删除。仅管理员。
sessionimgyoung_session<token>登录下发的会话 cookie；状态变更请求须另以 X-CSRF-Token 头回传会话绑定的 CSRF 令牌。
id*string用户 id
X-CSRF-Token*string登录或 GET /api/admin/me 响应里的 csrf_token；缺失或不匹配返回 403
curl -X DELETE 'http://localhost:8721/api/admin/users/string' \ -H 'X-CSRF-Token: string'全量语义，须给出全部键；内置管理员不可禁用或降级（403）。仅管理员。
sessionimgyoung_session<token>登录下发的会话 cookie；状态变更请求须另以 X-CSRF-Token 头回传会话绑定的 CSRF 令牌。
id*string用户 id
X-CSRF-Token*string登录或 GET /api/admin/me 响应里的 csrf_token；缺失或不匹配返回 403
application/json- body
更新请求，PUT 为全量语义，须给出全部键；未知字段整体拒绝
name*string登录名
role*Role角色
"admin""user"quota_bytes*integer配额上限；不大于 0 表示不限
int64default_ttl_hours*|上传默认有效期（小时）；null 随全局，0 永久
int640 <= value <= 876000disabled*boolean是否禁用；内置管理员不可禁用
curl -X PUT 'http://localhost:8721/api/admin/users/string' \ -H 'X-CSRF-Token: string' \ -H 'Content-Type: application/json' \ -d '{ "name": "string", "role": "admin", "quota_bytes": 0, "default_ttl_hours": 0, "disabled": true}'该用户全部会话失效；新密码至少 8 个字符。仅管理员。
sessionimgyoung_session<token>登录下发的会话 cookie；状态变更请求须另以 X-CSRF-Token 头回传会话绑定的 CSRF 令牌。
id*string用户 id
X-CSRF-Token*string登录或 GET /api/admin/me 响应里的 csrf_token；缺失或不匹配返回 403
application/json- body
password*string新密码，至少 8 个字符
passwordcurl -X POST 'http://localhost:8721/api/admin/users/string/password' \ -H 'X-CSRF-Token: string' \ -H 'Content-Type: application/json' \ -d '{ "password": "pa$$word"}'