群組 API

管理你的群組與成員。

取得群組列表

GET /api/channels

取得目前使用者有權限存取的所有群組。

回應

{
  "channels": [
    {
      "channelId": "C1234567890abcdef",
      "name": "購物討論群",
      "type": "group",
      "enabledAt": "2025-01-15T08:00:00Z",
      "status": "active"
    },
    {
      "channelId": "C0987654321fedcba",
      "name": "家族群組",
      "type": "group",
      "enabledAt": "2025-01-10T10:00:00Z",
      "status": "active"
    }
  ]
}

欄位說明

欄位	類型	說明
channelId	string	群組唯一識別碼
name	string	群組名稱
type	string	類型：`group`、`room`、`user`
enabledAt	string	啟用時間
status	string	狀態：`active`、`disabled`

取得群組詳情

GET /api/channels/:channelId

路徑參數

參數	說明
channelId	群組 ID

回應

{
  "meta": {
    "channelId": "C1234567890abcdef",
    "type": "group",
    "name": "購物討論群",
    "picture": "https://profile.line-scdn.net/...",
    "createdAt": "2025-01-15T08:00:00Z",
    "createdBy": "system",
    "memberCount": 150
  },
  "config": {
    "assistant": {
      "enabled": true,
      "qa": {
        "enabled": true,
        "mode": "keyword"
      },
      "welcome": {
        "enabled": true
      },
      "rules": {
        "enabled": true
      }
    },
    "backup": {
      "enabled": true
    }
  },
  "role": "owner"
}

欄位說明

meta

欄位	類型	說明
channelId	string	群組 ID
type	string	類型
name	string	名稱
picture	string	頭像 URL
memberCount	number	成員數量

config

欄位	說明
assistant	自動回覆設定
backup	備份設定

role

使用者在此群組的角色：

角色	說明	權限
`owner`	群組管理者	變更成員角色、管理所有設定
`admin`	管理員	管理自動回覆、歡迎訊息、群規等設定
`member`	一般成員	瀏覽群組資訊、存取備份訊息
`guest`	訪客	無權限，需由 owner/admin 升級為 member

取得群組成員

GET /api/channels/:channelId/members

回應

{
  "members": [
    {
      "userId": "U1234567890abcdef",
      "displayName": "王小明",
      "pictureUrl": "https://profile.line-scdn.net/...",
      "role": "owner",
      "joinedAt": "2025-01-15T08:00:00Z",
      "leftAt": null,
      "status": "active",
      "updatedAt": "2025-01-15T08:00:00Z"
    },
    {
      "userId": "U0987654321fedcba",
      "displayName": "李小華",
      "pictureUrl": "https://profile.line-scdn.net/...",
      "role": "member",
      "joinedAt": "2025-01-16T10:00:00Z",
      "leftAt": null,
      "status": "active",
      "updatedAt": "2025-01-16T10:00:00Z"
    }
  ]
}

欄位說明

欄位	類型	說明
userId	string	使用者 ID
displayName	string	顯示名稱
pictureUrl	string	頭像 URL
role	string	角色：`owner`、`admin`、`member`
joinedAt	string	加入時間
leftAt	string \| null	離開時間（null 表示仍在群組中）
status	string	狀態：`active`、`left`

更新成員角色

PUT /api/channels/:channelId/members/:userId/role

路徑參數

參數	說明
channelId	群組 ID
userId	使用者 ID

請求

{
  "role": "admin"
}

可設定的角色

角色	說明
admin	管理員（可管理設定）
member	一般成員（可瀏覽資訊）
guest	訪客（無權限）

回應

{
  "success": true
}

錯誤回應

403 Forbidden

{
  "error": "Permission denied"
}

可能原因：

你不是該群組的成員
你沒有足夠的權限（需要 admin 或 owner）
群組 ID 不存在或已被刪除