分組模組
功能說明
介面字首統一為 http(s)://<your-domain>
生產環境應使用 HTTPS 以保證認證令牌。 HTTP 僅建議用於開發環境。
簡單的分組名稱查詢介面 。主要用於管理員介面的下拉選擇元件,與使用者端的分組介面不同,僅返回名稱列表而不包含倍率等詳細資訊。
🔐 管理員鑑權
獲取全部分組列表
- 介面名稱:獲取全部分組列表
- HTTP 方法:GET
- 路徑:
/api/group/ - 鑑權要求:管理員
- 功能簡介:獲取系統中所有使用者分組的名稱列表,用於管理員配置和前端元件選擇
💡 請求示例:
const response = await fetch('/api/group/', {
method: 'GET',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer your_admin_token',
'New-Api-User': 'your_user_id'
}
});
const data = await response.json();✅ 成功響應示例:
{
"success": true,
"message": "",
"data": [
"default",
"vip",
"premium",
"enterprise"
]
}❗ 失敗響應示例:
{
"success": false,
"message": "獲取分組列表失敗"
}🧾 欄位說明:
data (陣列): 分組名稱列表,包含系統中所有已配置的使用者分組名稱