Servidor API

Inicia un servidor API REST integrado para generar etiquetas desde aplicaciones externas, apps Android, plugins de Chrome e integraciones personalizadas. Incluye un panel web completo con gestión de usuarios, monitoreo y API Explorer.

Panel de control

El panel de control en Label Creator permite iniciar, detener y configurar el servidor API.

Verificaciones del servidor

• Iniciar servidor — Iniciar el servidor API
• Detener Servidor — Detener el servidor
• Reiniciar Servidor — Reiniciar el servidor

Configuración

• Host — Dirección en la que escucha el servidor (por defecto: localhost)
• Puerto — Puerto del servidor (por defecto: 8000)
• Auto-start — Iniciar automáticamente el servidor al abrir la pantalla
• Desactivar apertura automática de ventana de depuración — No abrir la ventana de depuración al inicio
• Guardar Configuración — Guardar los ajustes
• Restablecer Contraseña de Administrador — Restablecer la contraseña del administrador

Estado del servidor

Muestra el estado actual del servidor (Started/Stopped) y la URL de acceso al panel web.

Gestión de perfiles y layouts

Importa, renombra, duplica y elimina perfiles y layouts disponibles a través de las APIs del servidor.

Perfiles del servidor API

Perfiles visibles y accesibles vía API (app Android, plugin Chrome, integraciones externas). Filtro rápido para buscar rápidamente. Botones: Importar desde local, Renombrar, Duplicar, Eliminar, Actualizar, Abrir carpeta.

API del servidor de diseño

Layouts visibles y accesibles vía API. Mismos controles que la pestaña de perfiles.

Compartir con clientes

Comparte físicamente perfiles, layouts y bases de datos permanentes con otras instalaciones de Label Creator configuradas como clientes. Selecciona los recursos y haz clic en Compartir seleccionados para compartirlos o Quitar compartición para revocar el uso compartido.

Panel web

Una vez iniciado el servidor, accede al panel web desde tu navegador. La página de bienvenida presenta cuatro secciones principales:

• Administration — Gestión de usuarios, permisos personalizados, configuración de páginas y estadísticas del sistema
• System Monitoring — Rendimiento del servidor, estado de servicios y estadísticas de uso en tiempo real
• API Explorer — Explora y prueba interactivamente todas las API REST con la interfaz Swagger integrada
• Guide and Documentation — Guías de uso, ejemplos prácticos y solución de problemas

Monitoreo del servidor

Monitoreo en tiempo real de registros, estadísticas y rendimiento del servidor.

Sistema

Métricas del sistema: CPU, memoria, E/S de disco, Uptime y conexiones activas.

Servidor API

Estadísticas de API: solicitudes totales, éxitos, errores, tasa de éxito y tiempo promedio de respuesta.

Solicitudes de las últimas 24 h

Gráfico de solicitudes de las últimas 24 horas con Quick Metrics para el total de solicitudes.

Registros del servidor

Registros del servidor con filtros por nivel y tipo. Botones Approve, Freeze y API Docs para gestionar los registros. Auto-refresh disponible.

Gestión de usuarios

Gestión avanzada de usuarios con roles, permisos y restricciones IP.

• User list — Tabla con Username, Email, Rol, Permisos, Estado, Restricciones IP, Offline Login y Acciones
• Filtros — Filtrar por nombre de usuario, rol, estado y restricciones IP
• New User — Crear un nuevo usuario
• Editar — Editar usuario existente
• Eliminar — Eliminar usuario

Editar usuario

Edita los detalles de un usuario: nombre de usuario, email, nombre completo, rol, contraseña, descripción y restricciones IP.

Permissions organizados por categoría:

• Core — Impresión de etiquetas (API), Funcionalidades avanzadas
• Profiles — Gestión de perfiles
• Admin — Administración
• Sistema — Monitoreo
• Herramientas — API Explorer

Explorador de API

Interfaz Swagger integrada para explorar y probar interactivamente todas las API REST del Label System.

• Server status — Servidor en línea con URL, Health Check, Webhooks y versión OpenAPI
• Authorize — Autenticar las solicitudes API
• Endpoints — Todos los endpoints agrupados por categoría (autenticación, generación de etiquetas, etc.)

Autenticación

Endpoints para login, logout, gestión de sesiones y verificación de permisos. Cada endpoint muestra el método HTTP (POST/GET), la ruta, los parámetros y las respuestas esperadas.

API de generación de etiquetas

Endpoints para la generación de etiquetas. Cada endpoint se expande para mostrar parámetros, botón Execute y respuestas con código y body de ejemplo.

Permisos de página

Configura qué roles pueden acceder a cada página del panel web. La tabla muestra Page Path, Description, Required Permissions, Modifiable y Actions.

Configurar permisos de página

La ventana de edición permite establecer el Page Path, la descripción, los permisos requeridos (Label Printing, Advanced Features, Profile Management, Administration, Monitoring, API Explorer) y si se requieren todos los permisos seleccionados o al menos uno.

Permisos personalizados

Visualiza y gestiona los permisos personalizados organizados por categoría: Core, Profiles, Admin y System. Los permisos del sistema no son editables.

Nuevo permiso personalizado

Crea un nuevo permiso personalizado especificando Permission Name, Display Name, Description y Category. El permiso estará disponible en la configuración de usuarios y páginas.

Seguridad y Auditoría

Registros de seguridad y pista de auditoría con una visión general de las actividades del sistema.

• Contadores — Events (login), Successful (logins), Failed (logins), Blocked IPs
• Pestañas — Dashboard, Audit Events, Blocked IPs, Timeline
• Recent Suspicious Activity — Actividades sospechosas recientes
• Top IPs by Activity — Direcciones IP más activas
• Active Users — Usuarios activos actuales
• Security Configuration — Configuración de seguridad del servidor

Estadísticas del sistema

Visión detallada de las estadísticas del sistema.

• Summary cards — Total de usuarios, Usuarios activos, Con restricciones IP, Inicios de sesión seguros (TLS)
• Users by Role — Distribución de usuarios por rol (admin, printer, etc.)
• Users by Permission — Distribución de usuarios por permiso asignado (print, advanced, profiles, admin, monitoring, api_explorer)