Skip to main content
Channels

解除 Channel 配对

解除 Channel 会话范围与其 Identity 的配对关系。

DELETE /api/v1/forward/channel_pairings/{pairing_id}

请求头

Header是否必填说明
Authorization是Bearer <PAT 或 SAT>

路径参数

参数类型是否必填说明
pairing_idstring是列出 Channel 配对、获取配对或完成配对返回的 id。

示例请求

curl -s -X DELETE 'https://api.qoder.com.cn/api/v1/forward/channel_pairings/pair_019eabc123' \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

示例响应

HTTP 200 OK
{
  "id": "pair_019eabc123",
  "deleted": true
}

响应字段

字段类型说明
idstringPairing ID。
deletedboolean成功解除时为 true。

HTTP 错误码

HTTPType触发条件
400invalid_request_errorpairing_id 为空白或含控制字符;查询配对归属时发现 Channel 非 pairing 模式。
401authentication_errorPAT 或 SAT 无效或已过期。
403permission_error无调用权限。
404not_found_error查询配对归属时,所属 Channel 不存在、已归档或不可访问。
409conflict_error绑定被并发修改。

注意事项

  • 不存在或已解绑的配对返回 200、deleted=true;仍存在的配对须通过访问权限校验。
  • 解除后原绑定失效;再次触发渠道配对流程可获取新配对码。

相关接口