使用者管理

管理員指南

使用者管理

查看和管理平臺所有註冊使用者

查看和管理平臺所有註冊使用者,包括修改角色、配額、分組,以及帳號狀態控制。使用管理員帳號登入後,於左側導覽點擊「使用者管理」,或直接存取 `/console/user`。Web 控制台列表頁與參考設計一致,正在串接中。

easyapi.com/console/user
新增使用者重新整理列表ID / 使用者名稱 / 顯示名稱選擇分組查詢重設
ID使用者名稱狀態剩餘/總額度分組角色邀請資訊操作
1admin已啟用∞ / ∞default管理員—停用 · 編輯 · 降級 · ···
2demo_user已啟用1200 / 5000default一般使用者邀請人 #1停用 · 編輯 · 提升 · ···

使用者列表示意:搜尋篩選 + 角色/狀態徽章 + 列內管理操作

編輯使用者

開啟編輯彈窗

  1. 在使用者列表的該列點擊「編輯」
  2. 或呼叫 GET /api/user/{id} 取得詳情後開啟表單
  3. 新建使用者請點擊「新增使用者」,對應 POST /api/user

修改使用者資訊

在彈窗中可調整以下欄位:

欄位說明
nickname · 顯示名稱使用者暱稱,於列表與個人資訊中顯示
username · 使用者名稱登入名稱;建立後可修改,需保持唯一
password · 密碼新建時必填;編輯時留空表示不修改
role · 角色一般使用者 / 管理員 / 超級管理員
group · 分組如 default、vip、test 等
quota · 額度帳戶總額度上限;可搭配已用額度查看剩餘
remark · 備註僅管理員可見的說明

列內「提升 / 降級」用於調整 role;「停用 / 啟用」切換 status,也可透過 POST /api/user/{id}/action 執行。

儲存修改

  • 編輯既有使用者:點擊「儲存」呼叫 PUT /api/user/{id}
  • 建立新使用者:填寫使用者名稱與初始密碼後 POST /api/user
  • 刪除使用者:DELETE /api/user/{id}(無法復原,請謹慎操作)
  • Root 可重設使用者 2FA:DELETE /api/user/{id}/2fa;重設 Passkey:DELETE /api/user/{id}/reset_passkey

搜尋使用者

使用搜尋功能

  • 支援依使用者 ID、使用者名稱、顯示名稱(nickname)關鍵字搜尋
  • 可依分組下拉篩選,僅顯示該分組使用者

查看搜尋結果

  • 點擊「查詢」呼叫 GET /api/users?keyword=;「重設」清空條件並恢復預設列表
  • 列表支援分頁與「重新整理列表」重新載入 GET /api/user/

列表由 GET /api/users 分頁回傳;帶 keyword 參數即為搜尋。

列表欄位說明

欄欄位說明
IDid使用者唯一識別碼
使用者名稱username登入帳號,唯一
狀態status已啟用 / 已停用;停用後無法登入與呼叫 API
剩餘額度/總額度quota - used_quota / quota帳戶可用額度與已用額度
分組group決定可用模型與渠道路由分組
角色role1 一般使用者、10 管理員、100 超級管理員
邀請資訊inviter_id / aff_code邀請人 ID 或推廣碼來源
  • 停用 / 啟用:切換 status;停用後立即無法登入
  • 編輯:開啟編輯彈窗,修改配額、分組、角色等
  • 提升 / 降級:調整 role(如一般使用者 ↔ 管理員)
  • 更多:刪除使用者、重設 2FA / Passkey 等(Root)

管理員側邊欄可在 個人設定 → 側邊欄模組中開啟 sidebar_modules.admin.user。分組與配額說明見 分組管理 與 配額與儲值。