88API88API
使用指南AI 應用API 文件幫助支援

分組模組

功能說明

介面字首統一為 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 (陣列): 分組名稱列表,包含系統中所有已配置的使用者分組名稱