グループモジュール

機能説明

インターフェースのプレフィックスは 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': 'Bearer your_user_id'
  }  
});  
const data = await response.json();

✅ 成功レスポンス例：

{  
  "success": true,  
  "message": "",  
  "data": [  
    "default",  
    "vip",  
    "premium",  
    "enterprise"  
  ]  
}

❗ 失敗レスポンス例：

{  
  "success": false,  
  "message": "获取分组列表失败"  
}

🧾 フィールド説明：

data （配列）: グループ名のリスト。システム内で設定されているすべてのユーザーグループ名が含まれます。