Discord Bot API 技能（高级）

目的

提供一份面向生产环境的指南，指导如何通过 REST API 与 Interactions 构建 Discord 机器人工作流，重点关注专业的命令用户体验（UX）、安全的操作实践，以及直接使用 HTTPS（不依赖任何 SDK）。

适用场景

• 你希望机器人以命令为核心进行交互，并具备清晰的用户操作流程。
• 你倾向于使用原生 HTTP 请求，避免引入第三方库依赖。
• 你需要一份结构化的 Discord API 接口能力全景图。

不适用场景

• 你需要完整的 SDK 或 Gateway 客户端实现。
• 你计划直接流式上传大体积媒体文件。

快速入门指引

• 阅读 references/discord-api-overview.md，了解基础 URL、版本控制策略及对象映射关系。
• 阅读 references/discord-auth-and-tokens.md，掌握 Token 类型及其对应的安全边界。
• 阅读 references/discord-interactions.md，理解 Interaction 生命周期与响应模式。
• 阅读 references/discord-app-commands.md，了解 Slash 命令、用户命令（User Commands）和消息命令（Message Commands）。
• 阅读 references/discord-messages-components.md，掌握消息格式、Embed 结构及交互组件（Components）。
• 阅读 references/discord-gateway-webhooks.md，对比 Gateway 与 Webhook 的适用场景与权衡取舍。
• 阅读 references/discord-rate-limits.md，了解限流机制及基于 HTTP Header 的应对策略。
• 阅读 references/discord-request-templates.md，获取标准 HTTP 请求载荷模板。
• 阅读 references/discord-feature-map.md，查看完整的 API 功能覆盖检查清单。

必需输入项

• Bot Token 和 Application ID。
• Interaction Endpoint 公钥（若使用 Interaction Webhook）。
• 命令列表及 UX 风格定义（语气、交互节奏等）。
• 允许启用的 Intents 及事件作用域（Event Scope）。

预期输出

• 一份清晰的机器人工作流规划、命令设计说明及可执行的运维检查清单。

运维注意事项

• 优先采用 Interaction 和 Slash 命令，而非前缀解析（prefix parsing）方式。
• 始终校验传入 Interaction 的签名（signature）。
• 保持请求/响应载荷精简，并对 Interaction 迅速作出响应。

安全注意事项

• 切勿记录 Token 或其他密钥信息。
• 遵循最小权限原则，仅申请必要的权限（Permissions）与作用域（Scopes）。