删除 Channel

删除指定 Channel。

DELETE /api/v1/forward/channels/{channel_id}

删除不再使用的 Channel。

​

请求头

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

​

路径参数

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

​

示例请求

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

​

示例响应

HTTP 200 OK

{
  "id": "channel_019eabc123",
  "deleted": true
}

​

响应字段

字段	类型	说明
id	string	被删除的 Channel ID。
deleted	boolean	是否删除成功，成功时恒为 true。

​

删除规则

• 删除成功后，该 Channel 不再处理新的上行消息，也不能继续用于扫码绑定或发送渠道回复。
• 删除是不可恢复操作；如果只是临时停止处理上行消息，应使用 Update Channel 设置 enabled=false。

​

错误码

HTTP	Type	触发条件
401	authentication_error	PAT 无效、过期或缺失。
404	not_found_error	Channel 不存在或当前调用方不可见。
502	api_error	Channel 删除失败。

​

相关

获取 Channel

更新 Channel