API REST de Rud1
Construye paneles a medida, dashboards de monitorización o integraciones con tu stack interno usando la misma API que alimenta nuestro panel oficial.
ℹ️ Esta sección está pensada para desarrolladores. Si solo quieres conectar un dispositivo y empezar a usarlo, ve a la guía de inicio — no necesitas tocar la API.
Resumen
La API REST de Rud1 expone los datos y operaciones de tu organización para consumo programático. La autenticación se hace con un bearer token (clave API) que generas desde Ajustes → Claves API. Cada clave se vincula a una organización y lleva un conjunto explícito de scopes (permisos) que define lo que puede hacer.
Generar mi primera clave
Abre el panel y crea una clave en menos de un minuto.
Ver el quickstart
Ejemplo end-to-end con curl, fetch y requests.
Qué puedes hacer
- Listar todos los dispositivos de tu organización, filtrados por estado, y obtener el detalle de cada uno.
- Leer las métricas de sistema (CPU, memoria, disco, temperatura, carga) muestreadas cada ~5 minutos por el agente.
- Consultar el flujo de eventos por dispositivo: heartbeats, alertas que se abren y se resuelven, USB, ciclo de vida del agente.
- Listar alertas activas, reconocerlas y resolverlas programáticamente desde tus propios sistemas.
Formato base
Todas las rutas están bajo https://www.rud1.es/api/v1/public y devuelven JSON con el mismo envelope:
// Respuesta correcta
{ "data": ... , "pagination": { ... } }
// Respuesta de error
{ "error": { "code": "string", "message": "string" } }💡 Las respuestas incluyen los headers X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset en cada llamada — no necesitas esperar a un 429 para saber tu cuota disponible.
Secciones de la documentación
Quickstart
Tu primera petición autenticada en menos de 5 minutos. curl, JavaScript y Python listos para copiar.
Autenticación
Cómo crear, rotar y revocar claves API. Formato del header, scopes disponibles y rate limits.
Referencia de endpoints
Catálogo completo de rutas: dispositivos, métricas, eventos y alertas. Parámetros, ejemplos y respuestas.
Errores y troubleshooting
Códigos de respuesta, formato de los errores, qué hacer cuando recibes 401, 403, 404, 429.
Soporte para desarrolladores
¿Echas en falta un endpoint, encuentras un comportamiento extraño o necesitas un caso de uso que no cubrimos? Escríbenos a support@rud1.es con el ID de tu clave (los primeros 16 caracteres, rud1_sk_…) y un ejemplo del request — nunca pegues el secreto completo.