用户 API

用户管理接口。

版本说明：企业版独有。个人版为本地单用户，无用户管理接口。所有路径位于 /api/v1/admin/users 前缀（注意并非 /api/users）。默认端口 8080。

---

GET /api/v1/admin/users

获取用户列表（分页）。

查询参数： page（默认 1）、page_size（默认 20）、role（admin/member/viewer）、tenant_id。

响应：

{
  "code": 0,
  "data": {
    "items": [
      {
        "id": "usr_2k8x9m3n",
        "username": "admin",
        "email": "admin@example.com",
        "role": "admin",
        "tenant_id": "tnt_default",
        "status": "active",
        "last_login": "2026-08-05T10:30:00Z",
        "created_at": "2026-01-01T00:00:00Z"
      }
    ],
    "total": 25,
    "page": 1,
    "page_size": 10
  },
  "message": "ok",
  "request_id": "req_abc123"
}

---

POST /api/v1/admin/users

创建用户。

字段	类型	必填	说明
username	string	✅	用户名，3–32 字符
password	string	✅	密码，至少 8 字符
email	string	✅	邮箱
role	string	-	member（默认）/admin/viewer
tenant_id	string	-	所属租户 ID

---

GET /api/v1/admin/users/:id

获取用户详情。

---

PUT /api/v1/admin/users/:id

更新用户（用户名、邮箱、角色、状态等）。

---

DELETE /api/v1/admin/users/:id

删除用户。

---

PUT /api/v1/admin/users/:id/password

修改用户密码。

---

PUT /api/v1/admin/users/:id/role

修改用户角色。

---

API Key 管理

方法	路径	说明
GET	/api/v1/admin/users/:id/api-keys	列出用户的 API Key
POST	/api/v1/admin/users/:id/api-keys	签发 API Key（可作 Bearer 令牌使用）
DELETE	/api/v1/admin/users/:id/api-keys/:keyId	吊销指定 Key

---

GDPR

DELETE /api/v1/admin/users/:id/gdpr —— 按 GDPR 擦除该用户数据（企业版合规能力）。

---

错误码

场景	code	message
用户不存在	40400	用户不存在
用户名已存在	40900	用户名已被注册
邮箱已注册	40900	邮箱已被使用
不能删除自己	40300	不能删除当前登录用户