跳转到主要内容
DELETE /api/v1/forward/channels/{channel_id} 删除不再使用的 Channel。

请求头

Header是否必填说明
AuthorizationBearer <PAT>

路径参数

参数类型是否必填说明
channel_idstringChannel 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
}

响应字段

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

删除规则

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

错误

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

相关

获取 Channel

更新 Channel