用戶

0總用戶數
0今日登錄
0活躍用戶
用戶 ID暱稱Email註冊時間最後登錄
尚無資料

數據概覽

總體計數與趨勢

0總用戶
0APP 總數
0聊天房間
0訊息總數

數量對比

趨勢(近 7 日)

應用列表

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

0 APP

尚無 APP

邊緣運算

依 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 形式儲存

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

用戶設置

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

接口文檔

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

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

管理員列表

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

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

創建管理員

需 canCreateAdmin 或 SuperAdmin 權限

HSystem Admin

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

版本:0.1.0

當前内部用量

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

接口測試

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

Log 系統管理

選擇要設定的紀錄類型,配置紀錄目標與觸發條件。未來可在此新增更多紀錄卡片。

管理員操作紀錄

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

管理員操作紀錄

設定紀錄目標 URL 以及要記錄的事件類型;讀取操作也可在此勾選是否紀錄。

紀錄目標

發送紀錄時使用的目標位址,請妥善保管勿外洩。若後端已有環境變數則可留空沿用。

記錄事件

勾選下列事件發生時要送出紀錄;未來讀取類操作也會在此顯示。

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

管理員登錄

以 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 接口,不使用目前頁面的登入狀態。

POST BASE_URL + /api/v1/admin/login
Response

                        

取得當前管理員(/me)

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

GET /api/v1/admin/me

說明

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

在線試一試(需要已登入 Token)

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

GET BASE_URL + /api/v1/admin/me
Response

                        

更新當前管理員(/me)

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

PATCH /api/v1/admin/me

請求範例

部分欄位更新
{
  "nickname": "New Nickname",
  "contact": {
    "email": "notify@example.com",
    "telegram": "@your-handle"
  }
}

在線試一試(更新自己)

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

PATCH BASE_URL + /api/v1/admin/me
Response

                        

創建管理員

由當前管理員創建新的子管理員,需具備 canCreateAdminsuperAdmin 權限。

POST /api/v1/admin/admins

在線試一試(創建管理員)

POST BASE_URL + /api/v1/admin/admins
Response

                        

管理員列表

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

GET /api/v1/admin/admins

在線試一試(管理員列表)

GET BASE_URL + /api/v1/admin/admins
Response

                        

單一管理員詳情

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

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

在線試一試(單一管理員)

GET BASE_URL + /api/v1/admin/admins/{id}
Response

                        

卸載管理員

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

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

在線試一試(卸載管理員)

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

DELETE BASE_URL + /api/v1/admin/admins/{id}
Response

                        

創建 APP

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

POST /api/v1/admin/apps

在線試一試(創建 APP)

POST BASE_URL + /api/v1/admin/apps
Response

                        

APP 列表

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

GET /api/v1/admin/apps

在線試一試(APP 列表)

GET BASE_URL + /api/v1/admin/apps
Response

                        

管理員快速 DEBUG

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

GET /me

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


                  

GET /admins

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


                  

GET /admins/:id

查詢單一管理員詳情。


                  

POST /admins(創建管理員)

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


                  

DELETE /admins/:id

卸載指定管理員(軟刪除)。


                  

GET /apps

取得目前可見的 APP 列表。


                  

POST /apps(創建 APP)

建立新 APP,名稱可自訂。