列出 Channels - Qoder CN 系列

按條件分頁列出外部 IM Channel。

要求標頭

Header	是否必填	說明
Authorization	是	`Bearer <PAT>`

查詢參數

參數	類型	是否必填	預設值	說明
`channel_type`	string	否	-	按 `wechat`、`qq`、`wecom`、`feishu` 或 `dingtalk` 過濾。
`enabled`	boolean	否	-	按人工啟停狀態過濾。
`binding_status`	string	否	-	按 `unbound`、`bound` 或 `expired` 過濾。
`identity_id`	string	否	-	按 Forward Identity ID 過濾。
`template_id`	string	否	-	按 Forward Template ID 過濾。
`limit`	integer	否	20	分頁大小，最大 100。
`after_id`	string	否	-	向後翻頁遊標。
`before_id`	string	否	-	向前翻頁遊標。

樣本請求

curl -s -X GET 'https://api.qoder.com.cn/api/v1/forward/channels' \
  -H "Authorization: Bearer $QODER_PAT"

樣本響應

HTTP 200 OK

{
  "data": [
    {
      "id": "channel_019eabc123",
      "type": "channel",
      "identity_id": "idn_019eabc123",
      "template_id": "tmpl_support",
      "channel_type": "feishu",
      "name": "Support Feishu channel",
      "enabled": true,
      "binding_status": "bound", 
      "channel_config": { 
       "response_options": { 
        "include_tool_calls": false, 
        "include_thinking": false 
        } 
      },
      "created_at": "2026-06-18T10:00:00Z",
      "updated_at": "2026-06-18T10:00:00Z"
    }
  ],
  "first_id": "channel_019eabc123",
  "last_id": "channel_019eabc123",
  "has_more": false
}

響應欄位

欄位	類型	說明
`data`	array	當前頁的 Channel 對象。
`first_id`	string\|null	當前頁第一條 Channel ID。
`last_id`	string\|null	當前頁最後一條 Channel ID。
`has_more`	boolean	是否還有更多記錄。

錯誤

HTTP	Type	Code	觸發條件
400	`invalid_request_error`	`invalid_pagination`	分頁參數不合法。
400	`invalid_request_error`	`channel_type_unsupported`	渠道類型過濾條件不支援。
401	`authentication_error`	`authentication_required`	PAT 無效或已到期。

備忘

after_id 和 before_id 不能同時傳入。
只返回當前調用方帳號邊界內的 Channel。

Qoder CN 系列：列出 Channels

要求標頭

查詢參數

樣本請求

樣本響應

響應欄位

錯誤

備忘

相關