Qoder CN シリーズ:チャネルの一覧表示

リクエストヘッダー

ヘッダー	必須	説明
Authorization	はい	Bearer <PAT>

クエリパラメーター

パラメーター	型	必須	デフォルト	説明
channel_type	文字列	いいえ	-	wechat、qq、wecom、feishu、または dingtalk でフィルタリングします。
enabled	ブール値	いいえ	-	手動での有効状態でフィルタリングします。
binding_status	文字列	いいえ	-	unbound、bound、または expired でフィルタリングします。
identity_id	文字列	いいえ	-	転送アイデンティティ ID でフィルタリングします。
template_id	文字列	いいえ	-	転送テンプレート ID でフィルタリングします。
limit	整数	いいえ	20	1 ページあたりの項目数。最大 100。
after_id	文字列	いいえ	-	指定されたチャネル ID に続くレコードのカーソル。
before_id	文字列	いいえ	-	指定されたチャネル ID より前のレコードのカーソル。

リクエスト例

curl -s -X GET 'https://api.qoder.com.cn/api/v1/forward/channels?identity_id=idn_019eabc123&limit=20' \
  -H "Authorization: Bearer $QODER_PAT"

レスポンス例

HTTP 200 OK

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

レスポンスフィールド

フィールド	型	説明
data	配列	現在のページのチャネルオブジェクトの一覧。
first_id	文字列|null	このページの最初のチャネルの ID。
last_id	文字列|null	このページの最後のチャネルの ID。
has_more	ブール値	さらにレコードが残っているかどうかを示します。

エラー

HTTP	タイプ	コード	トリガー
400	invalid_request_error	invalid_pagination	ページネーションパラメーターが無効です。
400	invalid_request_error	channel_type_unsupported	Channel type filter is unsupported.
401	—	TOKEN_INVALID	PAT が無効であるか、期限切れです。

注意事項

• after_id と before_id は相互排他的です。

• チャネルは、呼び出し元のアカウントの境界内でのみ返されます。

関連 API

• チャネルの作成

• チャネルの取得