Visión general de la API
La plataforma Mirox expone una API REST para que puedas integrar datos de planta, automatización e informes en tus propios sistemas y flujos de trabajo. Todo lo que hace la interfaz web está construido sobre los mismos endpoints públicos, así que puedes manejar la plataforma de forma programática.
Documentación interactiva
La especificación completa de la API se genera en vivo a partir de la plataforma en ejecución y está disponible en dos vistas interactivas:
- Swagger UI en
/docs— una referencia interactiva con un constructor de peticiones integrado para probar llamadas directamente en el navegador. - ReDoc en
/redoc— la misma especificación en un diseño optimizado para la lectura y la navegación.
Ambas vistas te permiten explorar cada endpoint disponible, sus parámetros, el cuerpo de la petición y el formato de la respuesta. Son la referencia autorizada y siempre actualizada de lo que puede hacer la API.
Cómo está organizada la API
Los endpoints de la API se agrupan según aquello sobre lo que actúan, y cada ruta está versionada (por ejemplo /v1/...). Las áreas comunes incluyen:
- Plantas, portfolios y componentes — consulta y gestiona tus emplazamientos monitorizados y su estructura.
- Métricas y exportación de datos — obtén datos de producción y de sensores en CSV o JSON, o construye métricas derivadas con MiroxQL.
- Eventos, tickets e informes — recupera señales detectadas por la máquina, el trabajo de seguimiento humano y los informes generados.
- Organización, cooperaciones y acceso — gestiona miembros, compartición y tokens de integración.
El acceso a cada endpoint se rige por tu rol y tus permisos. Una llamada solo devuelve las plantas y los datos que tienes derecho a ver, de modo que la API aplica las mismas reglas de acceso que la interfaz.
No todo aparece listado en /docs
Algunos grupos de rutas se ocultan intencionadamente de la especificación publicada, por lo que no aparecerán en /docs ni en /redoc aunque funcionen:
- Endpoints administrativos — funciones de administración de la plataforma reservadas al personal de Mirox.
- Rutas de asignación de dispositivos (
/v1/device).
Si necesitas integrarte con alguna de ellas, contacta con el soporte de Mirox para obtener orientación.
Acceso programático a datos en bruto
Para datos de series temporales en bruto y derivados, usa MiroxQL o la API de exportación de métricas. MiroxQL es la forma soportada de construir y consultar métricas de manera programática.
Primeros pasos
Para llamar a la API te autenticas con un token de API asignado a un grupo de permisos. Consulta la guía de Tokens de API para saber cómo crear, asignar y rotar tokens, y luego úsalos para hacer peticiones.
Abrir en Mirox
Crea y gestiona tus tokens en Perfil — abre el menú de perfil (arriba a la derecha) ▸ Perfil y usa la sección de tokens de API.
Para obtener código de integración ejecutable y de extremo a extremo, consulta el ejemplo trabajado Generador de informes externo.
Funciones relacionadas
- Tokens de API — crea y gestiona los tokens asignados que autentican tus llamadas a la API
- API de exportación de métricas — obtén datos de producción y de sensores en CSV o JSON
- MiroxQL — construye y consulta métricas derivadas con el motor de exportación por fórmulas
- Sistema de permisos — cómo los roles y los grupos de permisos rigen el acceso a la API