BotNetwork

Chuleta

Chuleta de la API de bots de Discord

Base REST: https://discord.com/api/v10 con cabecera Authorization: Bot <TOKEN>. Los eventos en tiempo real llegan por el WebSocket del Gateway, o como peticiones HTTP firmadas si usas una URL de endpoint de interacciones.

Intents privilegiados

  • GUILD_MEMBERS (1 << 1)
  • GUILD_PRESENCES (1 << 8)
  • MESSAGE_CONTENT (1 << 15) necesario para leer el texto fuera de menciones y MD
  • Actívalos en el Developer Portal; los bots verificados en 100 o más servidores necesitan aprobación.

Calculadora de permisos e intents

Respuestas a interacciones

  • 1 PONG (ping del endpoint HTTP)
  • 4 CHANNEL_MESSAGE_WITH_SOURCE
  • 5 DEFERRED_CHANNEL_MESSAGE_WITH_SOURCE (pensando...)
  • 6 DEFERRED_UPDATE_MESSAGE, 7 UPDATE_MESSAGE (componentes)
  • 8 AUTOCOMPLETE_RESULT, 9 MODAL
  • Responde en 3 segundos; haz seguimiento con el token durante 15 minutos. El flag 64 hace la respuesta efímera.

Comandos

  • PUT /applications/{app_id}/commands globales (sobrescritura masiva)
  • PUT /applications/{app_id}/guilds/{guild_id}/commands instantáneos, para pruebas
  • Tipos de opción: 3 STRING, 4 INTEGER, 5 BOOLEAN, 6 USER, 7 CHANNEL, 8 ROLE, 9 MENTIONABLE, 10 NUMBER, 11 ATTACHMENT

Constructor de comandos

Menciones y markdown

  • <@USER_ID>, <@&ROLE_ID>, <#CHANNEL_ID>
  • <t:UNIX:R> timestamps; estilos t T d D f F R
  • **bold** *italic* __underline__ ~~strike~~ ||spoiler|| `code`, ```lang bloques
  • Usa allowed_mentions para que el bot no mencione a @everyone por error.

Cabeceras de rate limit

  • X-RateLimit-Limit, X-RateLimit-Remaining
  • X-RateLimit-Reset-After (segundos), X-RateLimit-Bucket
  • X-RateLimit-Global, X-RateLimit-Scope en 429
  • Límite global de 50 peticiones por segundo; 10.000 peticiones no válidas en 10 minutos provocan un bloqueo temporal de IP.

Errores comunes

  • 50001 Missing Access el bot no ve el canal
  • 50013 Missing Permissions orden de roles o permisos del canal
  • 10062 Unknown interaction respondiste después de 3 segundos
  • 40060 Interaction has already been acknowledged
  • 4014 Disallowed intent(s) código de cierre del Gateway: activa el intent en el portal

Fuente: discord.com/developers/docs.

Última revisión con la documentación oficial: