ID del documento: KB-EV4-API-01 | Producto/Servicio: API REST de EloView 4 | Público: Integradores, Desarrolladores, Clientes Empresariales
Límites de tasa de la API de EloView 4 y mejores prácticas para la integración de alto volumen
La API REST de EloView permite a los clientes empresariales y socios de integración recuperar programáticamente información sobre dispositivos, 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, los comportamientos de autenticación y las mejores prácticas arquitectónicas para integraciones de 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/multidispositivo, limitar hilos concurrentes e implementar un retroceso exponencial 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 credencial de OAuth individual, cuenta de cliente, dirección IP fuente 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 fuente o punto final | No se aplican límites de tasa específicos. |
| Tasa de Solicitud de la Plataforma AWS (Compartida) | 10,000 solicitudes/segundo (Compartido globalmente por todos los clientes). |
| Capacidad de Aumento de AWS (Compartida) | 5,000 solicitudes (Compartido globalmente por todos los clientes). |
⚠️ Advertencia Crítica de Integración
Los límites de la plataforma compartida 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 responsable y eficiente de los recursos.
2. Autenticación OAuth y Gestión de Tokens
Un manejo inadecuado de tokens es una causa común de sobrecarga evitable en la API. 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 toda su duración válida. No generes un nuevo token para cada solicitud de API.
-
Renovación Proactiva: Renueva el token almacenado en caché poco antes de que expire, 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 total de la API.
3. Monitoreo de la Salud de la Flota y el Estado de los Dispositivos
Al monitorear la salud de los dispositivos y las implementaciones activas 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 controles de salud y estado de rutina, los intervalos de consulta de cada pocos minutos son suficientes.
-
Monitoreo de Implementaciones Activas: Para rastrear instalaciones activas, consulta
GET /device/{serial}/content/statusa un intervalo de 1 a 2 minutos. Detén la consulta una vez que la implementación alcance un estado finalizado (Éxito o Fallo).
4. Despliegues de Aplicaciones a Múltiples Dispositivos
El punto final POST /deployments admite la asignación a muchos dispositivos simultáneamente.
- Formatos de Destino: Especifica los destinatarios en una sola carga útil 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 seleccionará automáticamente todos los dispositivos en la cuenta. Usa este parámetro con extrema precaución.
- Restricciones por Lotes: Aunque el punto final no impone un límite rígido de número de serie, las cargas útiles siguen sujetas a la configuración de tamaño de lote de tu cuenta y a los permisos de operación por lote de la credencial de OAuth.
-
Respuestas por Exceso de Límite: Superar los límites de tu cuenta puede provocar 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. Utiliza colas y procesamiento por lotes para transmitir datos en lugar de ejecutar miles de puntos finales paralelos.
Respuestas Comunes de la API & Acciones
| Estado HTTP de la API | Significado & Acción Recomendada |
|---|---|
| HTTP 401 Unauthorized | Fallo de autenticación (por ejemplo, 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 usando retroceso exponencial con jitter aleatorio. |
| 400 BATCH_LIMIT_EXCEEDED | El tamaño de la carga útil excede los límites permitidos de ejecución por lotes. Revisa la configuración de la cuenta y particiona la transacción. |
⚙️ Estrategia de Retroceso de Lógica de Reintento
Al manejar respuestas HTTP 429, configura tu horario de reintento de manera progresiva (por ejemplo, 1s, 2s, 4s, 8s, 16s, 32s, hasta 60s como máximo) y aplica un retraso aleatorio (jitter) para evitar inundaciones de servicio localizadas. Nota: El retorno de la cabecera 'Retry-After' de la plataforma no está confirmado.
6. Resolución de Errores Inesperados de la API
Si tu integración experimenta interrupciones persistentes, revisa esta lista rápida de verificación de resolución de problemas:
-
Valida la URL Base: Confirma que estás llamando al gateway de EloView 4 (
https://secure-api.eloview.com) y no a un host legado de EloView 3. -
Verifica los Códigos de Estado: Aísla los problemas de autorización (
HTTP 401) de la limitación de infraestructura (HTTP 429). - Revisa los Métricas Operativas: Revisa la duración de reutilización de tokens, las frecuencias de consulta de cada quiosco, la utilización de puntos finales masivos y los conteos de concurrencia de hilos activos.
📞 Escalación a Soporte Técnico
Si los problemas inesperados de la API persisten, contacta a Soporte Técnico de Elo. Para acelerar la investigación, proporciona:
- URL base de la API y punto final específico llamado
- Tus direcciones IP públicas de salida
- Marcas de tiempo de evento precisas (incluida la zona horaria)
- Códigos de estado HTTP devueltos y cargas útiles completas de respuesta
Please report any broken links by emailing elo.support@zebra.com and include a link to the knowledge article