群組 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 - 一般成員

取得群組成員

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	一般成員

回應

{
  "success": true
}

錯誤回應

403 Forbidden

{
  "error": "Permission denied"
}

可能原因：

你不是該群組的成員
你沒有足夠的權限（需要 admin 或 owner）

404 Not Found

{
  "error": "Channel not found"
}

可能原因：

群組 ID 不存在
群組已被刪除