Qoder CN シリーズ:チャネルの更新

リクエストヘッダー

ヘッダー	必須	説明
Authorization	はい	Bearer <PAT>
Content-Type	はい	application/json
Idempotency-Key	いいえ	安全でないリクエストに対するオプションのべき等キーです。

パスパラメーター

パラメーター	タイプ	必須	説明
channel_id	文字列	はい	チャネル ID です。

リクエストボディ

パラメーター	タイプ	必須	説明
name	文字列	いいえ	チャネルの表示名です。
identity_id	文字列	いいえ	新しくバインドする転送アイデンティティの ID です。
template_id	文字列	いいえ	新しくバインドする転送テンプレートの ID です。
enabled	ブール値	いいえ	手動の有効/無効スイッチです。
channel_config.credentials	object	いいえ	更新用のチャネル認証情報。認証情報のローテーションに使用されます。
channel_config.response_options	object	いいえ	返信の表示設定です。

リクエストの例

curl -s -X POST 'https://api.qoder.com.cn/api/v1/forward/channels/ci_019eabc123' \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": false,
    "channel_config": {
      "response_options": {
        "include_tool_calls": true,
        "include_thinking": false
      }
    }
  }'

レスポンスの例

HTTP 200 OK

{
  "id": "ci_019eabc123",
  "type": "channel",
  "identity_id": "idn_019eabc123",
  "template_id": "tmpl_support",
  "channel_type": "feishu",
  "name": "Support Feishu channel",
  "enabled": false,
  "binding_status": "bound",
  "channel_config": {
    "response_options": {
      "include_tool_calls": true,
      "include_thinking": false
    }
  },
  "created_at": "2026-06-18T10:00:00Z",
  "updated_at": "2026-06-18T10:30:00Z"
}

レスポンスフィールド

更新されたチャネルオブジェクトを返します。

エラー

HTTP	タイプ	コード	トリガー
400	invalid_request_error	invalid_request	リクエストボディが無効です。
404	not_found_error	channel_not_found	チャネルが存在しません。
404	not_found_error	channel_template_not_found	新しいテンプレートが存在しません。
404	not_found_error	channel_identity_not_found	新しいアイデンティティが存在しません。
409	conflict_error	channel_identity_disabled	新しいアイデンティティが無効化されています。
401	authentication_error	authentication_required	PAT が無効であるか、有効期限が切れています。

注意事項

• id、type、および channel_type は更新できません。

• binding_status はシステムによって維持されます。

• enabled=true は手動スイッチをオンにするだけで、binding_status は変更されません。

• identity_id または template_id を更新すると、既存のアクティブなチャネルの会話はクローズされます。新しい受信メッセージは、新しいバインディングを使用します。

関連 API

• チャネルの取得

• チャネルのリスト表示