La API oficial de Discord es una superficie de bajo nivel pensada para bots y clientes: trabajas con eventos de pasarela, gestionas la caché a mano y te encargas de los intents. La API de servidor de Noxyr es una API HTTP de alto nivel, limitada a un único servidor, que devuelve analíticas ya terminadas. Resuelven problemas distintos. Esto es cuándo recurrir a cada una.
Lo que te da la API de Discord
La documentación de la API de Discord (muy buscada: Google Trends muestra que las consultas sobre "discord api documentation" han subido un 700 % interanual) es la fuente de verdad para todo lo que Discord gestiona directamente: mensajes, usuarios, servidores, roles, canales, voz, hilos y moderación. Obtienes una API REST para las acciones y una pasarela WebSocket para los eventos. Cualquier cosa en tiempo real requiere abrir una conexión persistente, gestionar READY y los heartbeats, invalidar la caché y controlar los buckets de límite de frecuencia.
Lo que te da la API de servidor de Noxyr
La API de servidor de Noxyr es una superficie mucho más pequeña: seis endpoints de solo lectura limitados a un único servidor mediante un token bearer. Responde preguntas como "¿cuántos tickets hay este mes?" o "ingresos por moneda", que la API de Discord no puede responder en absoluto, porque los datos subyacentes viven en la base de datos de Noxyr y no en Discord.
Comparación lado a lado
- Autenticación: Discord usa OAuth2 o tokens de bot con intents. Noxyr usa un token bearer por servidor.
- Transporte: Discord es REST + pasarela WebSocket. Noxyr es HTTPS normal con CORS habilitado para navegadores.
- Alcance: Discord es global para tu bot en todos los servidores donde está. Noxyr está vinculada a un servidor concreto.
- Forma de los datos: Discord devuelve objetos en bruto: servidores, miembros, mensajes. Noxyr devuelve agregados, totales, medias y cubos diarios.
- Límites de frecuencia: Discord usa límites por bucket y por ruta. Noxyr es un límite plano de 60 peticiones/min por clave.
- Esfuerzo de configuración: Discord necesita una app de bot, invitación, intents y manejadores de eventos. Noxyr necesita un clic para generar una clave.
Elige Discord cuando…
- Necesitas eventos en tiempo real (ha llegado un mensaje, se ha unido un miembro, ha cambiado un canal de voz).
- Quieres enviar mensajes, editar canales, banear usuarios o gestionar roles desde tu aplicación.
- Estás construyendo un bot de Discord o un cliente de Discord de terceros.
Elige la API de servidor de Noxyr cuando…
- Quieres mostrar estadísticas del servidor en vivo en una web pública sin mantener un bot.
- Necesitas analíticas de tickets, datos de ventas, medias de reseñas o participación en sorteos: datos que Discord no almacena.
- Quieres JSON compatible con CORS al que llamar desde un panel en el navegador sin proxy.
- Quieres una superficie estable y versionada en la que los interruptores de ámbito te permitan cortar la exposición de datos sin redesplegar nada.
Usar ambas juntas
Las dos APIs combinan bien. Usa la API de Discord en tu propio bot para reaccionar a los eventos, y la API de servidor de Noxyr para leer el estado agregado en tu web. Así tu panel público no necesita intents de bot ni conexiones a la pasarela: basta con una sola petición HTTPS.
Más información: tutorial de la API de servidor, principios de diseño, gestión de errores de la API de Discord.