跳转到主要内容
POST /api/v1/forward/channel_pairings 仅适用于 identity_resolution.mode=pairing 的 Channel。

请求头

请求体参数

示例请求

示例响应

HTTP 200 OK

响应字段

错误码

注意事项

  • 服务端使用 PAT 解析出的 user_id 与规范化后的 code 定位待配对记录——请求中无需传 channel_id
  • Pairing Code 在单个用户范围内唯一;响应中返回服务端解析的 channel_id
  • 使用相同 code、相同 Identity 和 Template 重复提交是幂等的,返回已有 Pairing;任何不同的绑定值将返回冲突。
  • Channel 是传输连接;Pairing 是该 direct/room scope 的实际执行上下文绑定。
  • 配对成功后 Forward 会尽力向原始会话发送成功通知;通知失败不会回滚 Pairing。

相关

创建 Channel

解除配对