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/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说明
400未提供可更新字段,或参数值不合法。
401凭证无效或已过期。
404已绑定记录、Identity 或 Template 不存在或无权访问。
409配对状态冲突,或新的 Identity 已停用。

相关接口