DELETE /api/v1/forward/channels/{channel_id}
删除不再使用的 Channel。
请求头
| Header | 是否必填 | 说明 |
|---|---|---|
| Authorization | 是 | Bearer <PAT> |
路径参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| channel_id | string | 是 | Channel ID,与 Channel 对象的 id 相同。 |
示例请求
示例响应
HTTP 200 OK响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
| id | string | 被删除的 Channel ID。 |
| deleted | boolean | 是否删除成功,成功时恒为 true。 |
删除规则
- 删除成功后,该 Channel 不再处理新的上行消息,也不能继续用于扫码绑定或发送渠道回复。
- 删除是不可恢复操作;如果只是临时停止处理上行消息,应使用 Update Channel 设置
enabled=false。
错误
| HTTP | Type | Code | 触发条件 |
|---|---|---|---|
| 401 | authentication_error | - | PAT 无效、过期或缺失。 |
| 404 | not_found_error | - | Channel 不存在或当前调用方不可见。 |
| 502 | api_error | - | Channel 删除失败。 |