Discord 机器人 API 技能 (高级)

目的

提供一个面向生产的指南，用于通过 REST API 和 Interactions 构建 Discord 机器人工作流，重点关注专业的命令用户体验、安全操作以及直接使用 HTTPS（无需 SDK）。

最适合

• 您希望机器人以命令为先，并拥有清晰的交互流程。
• 您倾向于使用直接的 HTTP 请求，而不依赖库。
• 您需要一个结构化的 Discord API 接口图谱。

不适合

• 您需要一个完整的 SDK 或网关客户端实现。
• 您计划直接流式传输大型媒体上传。

快速入门

• 阅读references/discord-api-overview.md以了解基础 URL、版本控制和对象映射。
• 阅读references/discord-auth-and-tokens.md以了解令牌类型和安全边界。
• 阅读references/discord-interactions.md用于交互生命周期和响应模式。
• 阅读references/discord-app-commands.md以了解斜杠命令、用户命令和消息命令。
• 阅读references/discord-messages-components.md以了解消息、嵌入内容和组件。
• 阅读references/discord-gateway-webhooks.md以了解网关与Webhook的权衡。
• 阅读references/discord-rate-limits.md以了解限流和基于请求头的处理。
• 阅读references/discord-request-templates.md以了解HTTP负载模板。
• 阅读references/discord-feature-map.md以获取完整的功能清单。

必需输入

• 机器人令牌和应用程序ID。
• 交互端点公钥（如果使用交互Webhook）。
• 命令列表与用户体验基调。
• 允许的意图与事件范围。

预期输出。

• 一份清晰的机器人工作流程计划、命令设计以及操作检查清单。

操作注意事项。

• 优先使用交互和斜杠命令而非前缀解析。
• 始终验证传入的交互签名。
• 保持载荷小巧并快速响应交互。

安全注意事项。

• 切勿记录令牌或密钥。
• 使用最小权限原则配置权限与范围。