Noxyr incluye ahora una API REST gratuita por servidor, para que puedas extraer datos de Discord en vivo (recuentos de miembros, analíticas de tickets, métricas de actividad, ventas, reseñas y sorteos) hacia tu web, tu panel, tu app móvil u otro bot. Una clave por servidor, generada desde el panel, protegida con hash SHA-256 y controlada por interruptores de ámbito que tú decides.
¿Por qué una API limitada al servidor?
La mayoría de los bots de Discord no exponen ningún dato o te obligan a pelearte con la API de Discord en bruto, con intents, conexiones al gateway y cálculos de límites de peticiones. La API del servidor de Noxyr es lo contrario: envías una cabecera y recibes JSON. Seis endpoints cubren las preguntas que de verdad hacen los propietarios de servidores: cuántos miembros hay, cuántos tickets se abrieron esta semana, ingresos por moneda, valoración media de las reseñas, sorteos en curso y tendencia de actividad diaria.
Lo que puedes leer hoy
GET /api/v1/server: nombre del servidor, URL del icono, recuento de miembros en vivo, recuento de conectados, boosts y fecha de creación.GET /api/v1/tickets: total / abiertos / cerrados, tickets abiertos en los últimos 7 y 30 días, cerrados en los últimos 7, valoración media y número de valoraciones.GET /api/v1/activity?days=30: mensajes, entradas y salidas diarias de hasta 90 días, rellenadas con ceros para que aparezca cada fecha.GET /api/v1/invoices: número de facturas, volumen y ingresos de los últimos 7 y 30 días por moneda, además de un desglose por estado de pago.GET /api/v1/reviews: total de reseñas publicadas, valoración media, desglose de 1 a 5 estrellas y las últimas 5 reseñas (producto, valoración, texto breve y autor).GET /api/v1/giveaways: número de sorteos activos y finalizados, total de participaciones y los 5 sorteos en curso que terminan antes.
Modelo de seguridad
Las claves empiezan por nxr_ y tienen 192 bits de entropía. En el servidor solo se guarda un hash SHA-256; la clave en bruto se muestra una sola vez al generarla y no se puede recuperar. Cada respuesta pasa por dos comprobaciones: si la clave está habilitada y si el ámbito de ese endpoint está activado. Desactivar un ámbito devuelve un 403 al instante; deshabilitar o revocar una clave corta todo el acceso sin necesidad de volver a desplegar nada. El límite de peticiones es por clave: 60 por minuto.
Primeros pasos (60 segundos)
- 1. Abre el panel, elige tu servidor y ve a Acceso a la API.
- 2. Pulsa Generar clave de API y copia el valor; es la única vez que se muestra.
- 3. Activa o desactiva los ámbitos. Cada ámbito tiene su propio interruptor.
- 4. Ejecuta
curl https://noxyrbot.com/api/v1/server -H "Authorization: Bearer nxr_YOUR_KEY"y ya estará en funcionamiento.
Integraciones habituales
Muestra un contador de miembros en vivo en tu página de inicio. Publica un resumen semanal de tickets en un canal privado del staff. Crea una clasificación pública de los que más participan en sorteos. Lleva los datos de ventas a una hoja de cálculo o a tu propio panel de administración. Como las respuestas son JSON sencillo con CORS permisivo, puedes llamar a la API desde el navegador sin ningún proxy.
Qué viene después
Lecturas relacionadas: API de Discord frente a la API del servidor de Noxyr, un tutorial paso a paso, los principios de diseño detrás de estos endpoints y cómo gestionamos los errores de la API de Discord.