HSystem Admin

0總用戶數

0今日登錄

0活躍用戶

用戶 ID	暱稱	Email	註冊時間	操作
尚無資料

數據概覽

總體計數與趨勢

0總用戶

0APP 總數

0聊天房間

0訊息總數

數量對比

趨勢（近 7 日）

應用列表

管理各產品 APP 的配置與數據

0 APP

尚無 APP

APP 名稱

app_001

概覽

當前 APP 基本資訊與統計

—

配置預覽

尚未設定頭像

尚未在配置中填寫簡介

數據統計

0 用戶數

0 聊天房間數

0 新的注冊

聊天房間

房間 ID	名稱	成員數	創建時間
尚無資料

訊息記錄

訊息 ID	房間	發送者	時間
尚無資料

模塊管理

登錄與支付模塊啟用開關

登錄模塊

帳號密碼

Email 驗證碼

手機驗證碼

支付模塊

PayPal

支付寶

Visa

遊戲幣

配置

來自 admin_apps.mate_data，用於該 APP 的橫幅、頭像、簡介、通知與登錄等

APP 改名

應用名稱

展示

可貼上圖片連結，或使用「上傳」取得圖片 URL。

頭像

在此編輯簡介後即時預覽

橫幅

頭像

APP 簡介

通知設置

啟用通知

通知通道

登錄要求

訪問頻率限制（選填）

每分鐘請求上限該 APP 配置頁與 API 調用

每日請求上限同一維度下每日累計

限制維度全應用共用額度；依帳號則按用戶分別計數

邊緣運算

依 mate_data.config.edge_shell 配置邊緣運算行為與對應權限組；權限組可為公共（KV）或個人覆寫。

0總調用

0被拒絕

調用 / 拒絕趨勢

當前配置摘要

載入中…

權限組

來源	群組名稱	Rate Limit	說明
載入中…

編輯權限組（一次性更新）

權限組配置將儲存在當前管理員的 mate_data.config.edge_shell.permission_groups 中；上方表格會先顯示公共權限組，再顯示個人覆寫。請以 JSON 陣列格式編輯後點擊「保存權限組」，將整體一次更新。

公共權限組

由 KV 維護的公共 permission_groups，具「編輯公共權限組」權限者可在此編輯。下方表格為唯讀預覽。

群組名稱	Rate Limit	說明
載入中…

通知引擎

管理通知通道、模板與發送規則（需具備「通知引擎」權限）

功能開發中，敬請期待。

聯係方式

用於驗證與通知配置（如驗證碼發送、Discord 通知等），資料以 JSON 形式儲存

手機區號

手機號碼

Email

Email 接收系統通知

勾選後，系統通知（如管理員操作紀錄等）可發送至上述 Email（實際發送依後端設定為準）

Discord User ID

mate_data 用於存放各 APP 的配置，請於各 APP 詳情頁中編輯。

用戶設置

修改當前帳號的登錄 Email、密碼、暱稱與 mate_data 配置

接口文檔

查看 HSystem REST API 路徑與說明，供前後端整合使用。

此文檔對應後端專案中的 HSystemWorker/docs/API.md。

管理員列表

管理您創建的管理員，可查看資料與模塊使用、卸載

Email	暱稱	狀態	創建時間	操作
載入中...

創建管理員

需 canCreateAdmin 或 SuperAdmin 權限

Email

確認 Email

密碼

確認密碼

暱稱（選填）

權限 Permissions

mate_data 配置（選填）

為該管理員設定登錄限制與邊緣運算等。僅在勾選對應權限時可填寫相關區塊；且您只能賦予您自己擁有的權限。留空則使用系統預設。

HSystem Admin

以 Cloudflare 為基礎的內部帳號與支付平台管理介面。

版本：0.1.0

用戶設置

修改登錄帳號、密碼與 mate_data 等，僅在勾選對應權限時可編輯相關區塊。

當前内部用量

具備「查看内部用量」或 SuperAdmin 權限時可進入内部用量查看。

接口測試

打開「接口文檔 - 管理員」的遊樂園式測試頁，一邊閱讀說明一邊直接呼叫接口。

加入社群

歡迎加入我們的 Discord 群組。

管理員操作紀錄

登入、權限調整、創建/卸載管理員等，可設定紀錄目標與要記錄的事件（含讀取操作）。

HSystem API Index

接口文檔 - 目錄

這裡作為 HSystem 對外 REST API 的「目錄頁」，按模塊整理重點路徑與用途；更完整的參數與錯誤碼請參考後端專案中的 HSystemWorker/docs/API.md。

認證 Auth

登入、註冊與找回帳號等通用認證流程。

涵蓋登入、註冊、忘記密碼/帳號與多步驟驗證。

POST /api/v1/auth/login

支付 Payment

模塊化的支付方式，可在後台動態啟用/停用。

提供可配置的支付模塊，方便按 APP 启用或停用。

GET /api/v1/payment/options

管理員 Admin

後台管理員的登入、權限與 APP 管理接口。

管理員登入、權限分配與 APP 管理的後台接口入口。

POST /api/v1/admin/login

內部服務 Internal

供 HSystem 本身或受信任服務使用的內部接口。

包含驗證碼、通知與跨 APP 用戶標準化查詢等內部服務。

POST /api/v1/internal/notify-email

本頁僅作為管理後台快速總覽，實際請求格式與錯誤碼請以 API.md 為準。

接口文檔 - 管理員

像遊樂園一樣，一個一個接口慢慢玩。

完整欄位與錯誤碼請參考 HSystemWorker/docs/API.md。

管理員登錄

以 Email + 密碼登入管理後台，回傳可在本系統中使用的 token。

POST /api/v1/admin/login

說明

此接口通常只在「登入畫面」使用一次；成功後會取得一個管理員存取令牌，之後調用所有 /api/v1/admin/* 相關接口都需在 Header 中帶上 Authorization: Bearer <token>。

請求範例

Request JSON

{
  "email": "admin@example.com",
  "password": "your-password"
}

Response JSON（成功）

{
  "code": 0,
  "data": {
    "id": "admin-uuid",
    "email": "admin@example.com",
    "nickname": "Admin",
    "token": "eyJhbGciOi..."
  }
}

在線試一試（登入）

這裡會直接呼叫實際的 Worker 接口，不使用目前頁面的登入狀態。

取得當前管理員（/me）

依照當前的 Bearer Token 取得管理員基本資料與聯係方式。

GET /api/v1/admin/me

說明

適合在後台載入時顯示目前登入的是哪一位管理員，以及讀取其 contact 設定與其他 Profile 資訊。

在線試一試（需要已登入 Token）

將自動帶入目前登入管理員的 Authorization，用來直接測試 /me。

更新當前管理員（/me）

修改自己的聯係方式、暱稱或登入 Email / 密碼等資料。

PATCH /api/v1/admin/me

請求範例

部分欄位更新

{
  "nickname": "New Nickname",
  "contact": {
    "email": "notify@example.com",
    "discord_user_id": "123456789012345678"
  }
}

在線試一試（更新自己）

請輸入要修改的欄位；未出現在 JSON 中的欄位將保持不變。

創建管理員

由當前管理員創建新的子管理員，需具備 canCreateAdmin 或 superAdmin 權限。

POST /api/v1/admin/admins

在線試一試（創建管理員）

管理員列表

查看目前可見的管理員列表（SuperAdmin 可看全部）。

GET /api/v1/admin/admins

在線試一試（管理員列表）

單一管理員詳情

查詢某一位管理員的詳細資料與 mate_data。

GET /api/v1/admin/admins/:id

在線試一試（單一管理員）

卸載管理員

將指定管理員標記為卸載／停用，實際權限會失效。

DELETE /api/v1/admin/admins/:id

在線試一試（卸載管理員）

請小心使用，卸載後該管理員將無法再登入。

創建 APP

在 HSystem 中建立一個新的應用節點，APP ID 由 Worker 自動產生。

POST /api/v1/admin/apps

在線試一試（創建 APP）

APP 列表

查看目前可見的應用清單，通常用於後台選單或設定頁。

GET /api/v1/admin/apps

在線試一試（APP 列表）

管理員快速 DEBUG

分頁進行管理員接口與 APP 接口的快速測試，可輸入參數並查看完整請求與回應。

GET /me

取得當前管理員資料，驗證 Token 是否有效。

GET /admins

取得管理員列表（依權限顯示自己創建或全部）。

GET /admins/:id

查詢單一管理員詳情。

管理員 ID

POST /admins（創建管理員）

需 canCreateAdmin 權限。Email、密碼必填。

Email

密碼

暱稱（選填）

DELETE /admins/:id

卸載指定管理員（軟刪除）。

管理員 ID

GET /apps

取得目前可見的 APP 列表。

POST /apps（創建 APP）

建立新 APP，名稱可自訂。

APP 名稱

APP ID

從下拉選擇已存在的 APP，或手動輸入 UUID。下方接口會使用此 APP ID。

GET /auth/options

取得該 APP 的登錄模塊選項（需上方 APP ID）。

POST /auth/register

用戶註冊（account + password）。

account

password

nickname（選填）

POST /auth/login

用戶登錄（account + password）。

account

password

基本資料

Email: —
暱稱: —
登錄密碼: 已設定
權限

HSystemAdministrator System

管理員登錄

HSystemAdministrator System

輸入驗證碼

數據概覽

數量對比

近 7 日活躍趨勢

編輯應用

設置

接口文檔離線包

關於

管理員相關接口

數據概覽

數量對比

趨勢（近 7 日）

應用列表

APP 名稱

概覽

—

配置預覽

數據統計

聊天房間

訊息記錄

分享

模塊管理

登錄模塊

支付模塊

配置

APP 改名

展示

裁切

通知設置

登錄要求

訪問頻率限制（選填）

相關法律協議

相關協議MD編輯器

邊緣運算

調用 / 拒絕 趨勢

當前配置摘要

權限組

編輯權限組（一次性更新）

公共權限組

編輯公共權限組（JSON）

通知引擎

聯係方式

用戶設置

接口文檔

管理員列表

創建管理員

mate_data 配置（選填）

🔐 登錄限制

邊緣運算

👥 添加管理員規則

管理員詳情

用戶設置

—

基本資料

mate_data

登錄帳號

修改密碼

請確認變更

HSystem Admin

用戶設置

當前内部用量

接口測試

加入社群

Log 系統管理

管理員操作紀錄

記錄事件

接口文檔 - 目錄

認證 Auth

支付 Payment

管理員 Admin

內部服務 Internal

說明

請求範例

在線試一試（登入）

說明

在線試一試（需要已登入 Token）

請求範例

HSystem
Administrator System

HSystem
Administrator System

調用 / 拒絕趨勢

登錄限制

添加管理員規則