Skip to main content

删除 Channel

请求头

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

路径参数

参数类型是否必填说明
channel_idstring是Channel ID，与 Channel 对象的 id 相同。

示例请求

curl -s -X DELETE 'https://api.qoder.com.cn/api/v1/forward/channels/ci_019eabc123' \
  -H "Authorization: Bearer $QODER_PAT"

示例响应

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

响应字段

字段类型说明
idstring被删除的 Channel ID。
deletedboolean是否删除成功，成功时恒为 true。

删除规则

  • 删除前服务端校验 Channel 归属于当前鉴权主体；不存在或无权访问返回 404 not_found_error。
  • 删除成功后，该 Channel 不再处理新的上行消息，也不能继续用于扫码绑定或发送渠道回复。
  • 删除后再次查询该 Channel 返回 404 not_found_error。
  • 删除不影响已经产生的历史 Session、消息、计费和观测记录；历史数据仍按各自资源的保留策略处理。
  • 删除是不可恢复操作；若只是临时停止处理上行消息，应使用 更新 Channel 设置 enabled=false。

错误

HTTPTypeCode触发条件
401authentication_error-PAT 无效、过期或缺失。
404not_found_error-Channel 不存在或当前调用方不可见。
502api_error-Gateway 删除运行态实例失败。

相关