Skip to main content
Channels

更新 Channel 配对

修改已绑定 Channel 配对记录的 Identity 或 Template。

Channel 配对目前为 Beta 功能，接口定义、响应结构和行为可能调整，请关注文档更新。
POST /api/v1/forward/channel_pairings/{pairing_id} 修改已绑定（active）记录的 Identity 或 Template。未绑定记录请使用完成配对。

请求参数

使用 Authorization: Bearer <PAT 或 SAT> 和 Content-Type: application/json。路径参数 pairing_id 必填，为配对记录的 id。
请求体参数类型说明
identity_idstring新的 Identity ID。
template_idstring新的 Template ID。
至少传一个字段，未传字段保持不变，不支持空白字符串、null、非字符串、控制字符或未知字段。Channel 和配对范围不可修改。scope_display_name 由渠道消息提供，不支持手动修改。

示例请求

curl -s -X POST 'https://api.qoder.com.cn/api/v1/forward/channel_pairings/pair_019eabc123' \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"template_id":"tmpl_support"}'

响应

成功返回 HTTP 200 OK，响应为更新后的配对对象，结构与获取配对一致，status 仍为 active。 绑定发生变化后，新消息使用新的执行配置，已有会话不再继续复用。重复提交相同值不会再次变更绑定。

HTTP 错误码

HTTPType触发条件
400invalid_request_error请求参数不符合上述约束，pairing_id 为空白或含控制字符，或 Channel 非 pairing 模式。
401authentication_errorPAT 或 SAT 无效或已过期。
403permission_error无调用权限。
404not_found_error有效配对绑定、Channel、Identity 或 Template 不存在或不可访问，或 Channel 已归档。
409conflict_error配对状态冲突、绑定被并发修改，或目标 Identity 已停用。

相关接口

列出 Channel 配对

获取配对

解除配对

更新 Channel 配对 - Qoder CN