用途:通过 Discord API v10 列出指定服务器(guild)内的全部频道,包括文本、语音、分类、公告、舞台和论坛频道。适用于列出全部频道、按名称查找频道、获取频道 ID 供其他操作使用、审计服务器频道结构、按类型筛选频道,以及导出频道列表用于文档。
主要能力:一次请求返回服务器全部频道,无需分页;每个频道对象包含 id、name、type、position、parent_id、permission_overwrites 等字段,语音频道还含 bitrate、user_limit、rtc_region。频道类型值:0 文本、2 语音、4 分类、5 公告、13 舞台、15 论坛。可按类型、名称或 parent_id(所属分类)筛选,也可按 position 排序、按分类分组,并支持简单列表、详细列表、层级列表和 CSV 等输出形式。
使用方式:需先设置 DISCORD_BOT_TOKEN 环境变量,机器人须为目标服务器成员并具备“查看频道”权限,且需提供有效的 18-19 位服务器 ID。核心请求为:curl -X GET "https://discord.com/api/v10/guilds/{GUILD_ID}/channels" -H "Authorization: Bot ${DISCORD_BOT_TOKEN}"。可配合 jq 做客户端筛选,例如按类型 select(.type == 0)、按名称 select(.name | contains("general"))、按分类 select(.parent_id == "category_id_here"),或 sort_by(.position) 排序。
响应码:200 成功;401 令牌无效;403 机器人不在服务器或权限不足;404 服务器不存在。
限制:机器人只能看到其有权限查看的频道,私有频道可能不出现;权限覆盖不影响该端点的可见性。建议缓存结果、客户端筛选、按 position 排序、按分类分组,并始终显示频道 ID。资料未提供具体收费、价格或平台支持信息。