Discord
Bots, servidores y mensajes de Discord desde su API oficial.
Ver la documentaciónPara qué sirve
Qué problema resuelve
La API de Discord permite crear bots y apps que envían mensajes, gestionan roles, leen canales (con permisos) o responden a interacciones.
No pagas por «llamar a la API»: el coste está en cumplir rate limits y las reglas de la plataforma.
En la práctica
Qué puedes hacer con ella
- Registrar un bot y responder mensajes en un servidor.
- Crear comandos slash e interacciones.
- Gestionar roles, canales o miembros si el bot tiene permisos.
- Publicar anuncios automáticos desde otro sistema.
- Reaccionar a eventos en tiempo casi real vía Gateway (además del HTTP).
¿Es gratis?
Bots gratis con rate limits
Crear apps/bots en Discord es gratuito. Hay rate limits por ruta y un global de hasta 50 requests por segundo por bot (si no hay Authorization, el global aplica a la IP). No hardcodees los límites: usa las cabeceras y el 429 con retry_after. Demasiadas peticiones inválidas (401/403/429) pueden acabar en ban temporal de Cloudflare (orden de 10.000 inválidas / 10 minutos).
Comprobado el 2026-08-02. Fuente: página oficial de precios o límites
Abrir Discord Developer Portal
Qué cuenta como una «llamada» aquí
Cada request HTTP a la API (p. ej. POST de un mensaje) cuenta para el bucket de esa ruta y para el contador global del bot.
No hay créditos de pago por mensaje en la API HTTP básica. Los límites existen para evitar spam y caídas; si recibes 429, espera retry_after segundos.
Rate limits Discord
| Límite | Cuota | Qué significa en la práctica |
|---|---|---|
| Global por bot | Hasta 50 requests / segundo | Documentado como techo global; no lo hardcodees a ciegas, mira cabeceras. |
| Por ruta (bucket) | Variable | Cada endpoint puede tener su propio X-RateLimit-*. Usa el header Bucket. |
| Invalid Request Limit | 10.000 inválidas / 10 min | Demasiados 401/403/429 pueden restringir tu IP temporalmente. |
Coste
| Plan | Precio | Para quién | Qué incluye (resumen) |
|---|---|---|---|
| Bot / Application | $0 por request HTTP | Desarrolladores de bots y apps. | API y Developer Portal; sujeto a ToS y rate limits. |
Uso permitido, comercial y licencia
| Pregunta | Respuesta clara |
|---|---|
| ¿Open source? | Discord es un servicio comercial. Hay librerías de bots open source de terceros. |
| ¿Uso comercial? | Permitido dentro de los Developer Terms y las políticas de bots (no spam, respetar privacidad). |
| ¿Hace falta cuenta? | Sí: cuenta Discord + aplicación/bot en el Developer Portal. El token del bot es secreto. |
Cómo empezar
Crear un bot y comprobar GET /users/@me.
Necesitas cuenta Discord y una aplicación en el Developer Portal.
Dirección base de las imágenes: https://discord.com/api/v10
- 01
Paso 1
Entra en https://discord.com/developers/applications y crea una Application → Bot.
- 02
Paso 2
Copia el bot token y guárdalo fuera del código del cliente.
- 03
Paso 3
Haz GET https://discord.com/api/v10/users/@me con Authorization: Bot TU_TOKEN.
- 04
Paso 4
Invita el bot a un servidor de prueba con la URL OAuth2 del portal (scopes bot/applications.commands según necesites).
- 05
Paso 5
Si llega 429, espera retry_after. Docs de límites: https://docs.discord.com/developers/topics/rate-limits
Con tu agente
Prompt para integrar la API
Prompt para que tu agente lo deje listo
Pega esto en Cursor, Claude Code, Codex u otro agente de código:
Integra Discord API. Docs: https://discord.com/developers/docs/intro . Rate limits: https://docs.discord.com/developers/topics/rate-limits . Base: https://discord.com/api/v10 . No inventes bot tokens ni guild ids: pídemelos. Respeta 429 y no hardcodees límites. ¿Mensajes, slash commands o roles primero?Detalle técnico
Acceso, HTTPS y CORS
- 01
Acceso · OAuth
Requiere flujo OAuth: el usuario autoriza tu aplicación antes de leer sus datos.
- 02
HTTPS · Sí
Sirve sobre TLS, así que vale para producción y para páginas ya en HTTPS.
- 03
CORS · Sin verificar
No consta si permite llamadas desde el navegador; pruébalo antes de montar el cliente.