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。