ID del documento: KB-EV4-API-01 | Producto/Servicio: EloView 4 REST API | Público objetivo: Integradores, Desarrolladores, Clientes Empresariales
Límites de tasa de la API de EloView 4 y mejores prácticas para integraciones de alto volumen
La API REST de EloView permite a los clientes empresariales y socios de integración recuperar información del dispositivo de manera programática, monitorear la salud de la flota, gestionar contenido y desplegar aplicaciones. Este artículo describe los límites de tasa de la API de EloView 4, comportamientos de autenticación y mejores prácticas arquitectónicas para integraciones API confiables y de alto volumen.
💡 Resumen Rápido
EloView 4 no aplica límites de API específicos para cada cliente. Para una confiabilidad óptima, las integraciones deben almacenar en caché los tokens de OAuth, favorecer consultas masivas/multi-dispositivo, limitar los hilos concurrentes e implementar retrocesos exponenciales con jitter para el manejo de errores.
1. Límites de tasa de la API de EloView 4
EloView 4 no aplica límites de tasa por cada credencial de OAuth individual, cuenta de cliente, dirección IP origen o punto final de API. La URL base de la API de producción es:
https://secure-api.eloview.com
| Parámetro | Límite / Capacidad |
|---|---|
| Por credencial, cuenta, IP origen o punto final | No se aplican límites de tasa específicos. |
| Tasa de Solicitudes de la Plataforma AWS (Compartida) | 10,000 solicitudes/segundo (Compartida a nivel global por todos los clientes). |
| Capacidad de Estallido de la Plataforma AWS (Compartida) | 5,000 solicitudes (Compartida a nivel global por todos los clientes). |
⚠️ Advertencia Crítica de Integración
Los límites de plataforma compartidos mostrados arriba no son cuotas reservadas por cliente. Para evitar problemas de rendimiento y proteger la estabilidad de la plataforma, las integraciones deben diseñarse para un uso de recursos eficiente y responsable.
2. Autenticación OAuth y Gestión de Tokens
El manejo incorrecto de tokens es una causa común de sobrecarga de API evitable. Por favor, estructura tu lógica de autenticación basada en las siguientes reglas:
-
Duración del Token: Los tokens de acceso son válidos por 24 horas (
expires_in = 86400). - Caché y Reutilización: Almacena en caché y reutiliza los tokens de acceso durante su duración válida. No generes un nuevo token para cada solicitud de API.
-
Renovación Proactiva: Renueva el token en caché poco antes de su vencimiento, o inmediatamente al recibir una respuesta
HTTP 401 Unauthorized. - Credenciales vs. Capacidad: Si bien los administradores de cuentas pueden crear múltiples credenciales de OAuth, utilizar múltiples credenciales no aumenta tu capacidad general de API.
3. Monitoreo del Estado de la Flota y Dispositivos
Al monitorear la salud de los dispositivos y los despliegues activos a gran escala, optimiza el diseño de tus consultas para reducir la sobrecarga de red:
-
Auditorías de Estado de Rutina: Utiliza puntos finales de consulta masiva—como
GET /devicesoPUT /devices/search—para recuperar registros de estado para múltiples dispositivos en una sola llamada. Evita consultarGET /devices/{serial}individualmente para cada quiosco. - Intervalos de Consulta (Inactivo): Para chequeos rutinarios de salud y estado, intervalos de consulta de cada pocos minutos son suficientes.
-
Monitoreo de Despliegues Activos: Para rastrear instalaciones activas, consulta
GET /device/{serial}/content/statusen un intervalo de 1 a 2 minutos. Deja de consultar una vez que el despliegue alcance un estado finalizado (Éxito o Fallo).
4. Despliegues de Aplicaciones a Múltiples Dispositivos
El punto final POST /deployments admite apuntar a muchos dispositivos simultáneamente.
- Formatos de Apuntado: Especifica los destinatarios en un solo payload de solicitud utilizando una lista de números de serie, grupos de dispositivos o criterios de consulta.
- El Objetivo de Consulta Vacío: Dejar la consulta de destino en blanco apuntará automáticamente a todos los dispositivos en la cuenta. Usa este parámetro con sumo cuidado.
- Restricciones de Lote: Aunque el punto final no impone un límite rígido de número de serie, los payloads siguen sujetos a la configuración de tamaño de lote de tu cuenta y los permisos de operación por lote de la credencial de OAuth.
-
Respuestas Excediendo el Límite: Exceder los límites de tu cuenta puede activar un error
400 BATCH_LIMIT_EXCEEDED, o requerir verificación manual siPENDING_FOR_APPROVALestá configurado.
5. Concurrencia, Errores de API y Reintentos
Las integraciones deben mantener un perfil de concurrencia conservador. Mantén las solicitudes paralelas activas restringidas a 5–10 conexiones concurrentes. Usa colas y procesamiento por lotes para transmitir datos en lugar de ejecutar miles de puntos finales en paralelo.
Respuestas y Acciones Comunes de la API
| Estado HTTP de la API | Significado y Acción Recomendada |
|---|---|
| HTTP 401 Unauthorized | Fallo de autenticación (p. ej., token expirado o revocado). Verifica las credenciales de autenticación y solicita un nuevo token. |
| HTTP 429 Too Many Requests | Limitación de tasa de la plataforma. Implementa lógica de reintento utilizando retroceso exponencial con jitter aleatorio. |
| 400 BATCH_LIMIT_EXCEEDED | El tamaño del payload excede los límites de ejecución permitidos por lote. Revisa la configuración de la cuenta y divide la transacción. |
⚙️ Estrategia de Retroceso de Lógica de Reintento
Al manejar respuestas HTTP 429, configura tu horario de reintento progresivamente (p. ej., 1s, 2s, 4s, 8s, 16s, 32s, hasta un máximo de 60s) y aplica un retraso aleatorio (jitter) para evitar inundaciones de servicio localizadas. Nota: El retorno de la plataforma del encabezado 'Retry-After' no está confirmado.
6. Resolución de Errores Inesperados de la API
Si tu integración experimenta interrupciones persistentes, revisa esta lista de verificación rápida de resolución de problemas:
-
Valida la URL Base: Confirma que estás llamando a la pasarela EloView 4 (
https://secure-api.eloview.com) y no a un host de EloView 3 antiguo. -
Verifica los Códigos de Estado: Aísla los problemas de autorización (
HTTP 401) de la limitación de infraestructura (HTTP 429). - Revisa Métricas Operacionales: Revisa las duraciones de reutilización de tokens, frecuencias de consulta de kioscos individuales, utilización de puntos finales masivos y recuentos de concurrencia de hilos activos.
📞 Escalando a Soporte Técnico
Si persisten problemas inesperados de API, contacta a Soporte Técnico de Elo. Para acelerar la investigación, por favor proporciona:
- URL base de la API y punto final específico llamado
- Tus direcciones IP origen públicas de salida
- Marcas de tiempo de eventos precisas (incluida la zona horaria)
- Códigos de estado HTTP devueltos y cargas útiles de respuesta completas
Please report any broken links by emailing elo.support@zebra.com and include a link to the knowledge article