ID do Documento: KB-EV4-API-01 | Produto/Serviço: EloView 4 REST API | Público: Integradores, Desenvolvedores, Clientes Empresariais
Limites de Taxa da API EloView 4 e Melhores Práticas de Integração em Alta Escala
A API REST EloView permite que clientes empresariais e parceiros de integração recuperem programaticamente informações sobre dispositivos, monitorem a saúde da frota, gerenciem conteúdo e implantem aplicativos. Este artigo descreve os limites de taxa da API EloView 4, comportamentos de autenticação e melhores práticas arquitetônicas para integrações de API confiáveis e em alta escala.
💡 Visão Geral Rápida
EloView 4 não aplica limites de API específicos por cliente individual. Para confiabilidade ideal, as integrações devem armazenar em cache tokens OAuth, favorecer consultas em massa/múltiplos dispositivos, limitar threads concorrentes e implementar retardo exponencial com jitter para tratamento de erros.
1. Limites de Taxa da API EloView 4
EloView 4 não impõe limites de taxa por credencial OAuth individual, conta de cliente, endereço IP de origem ou ponto final da API. A URL base da API de produção é:
https://secure-api.eloview.com
| Parâmetro | Limite / Capacidade |
|---|---|
| Por credencial, conta, IP de origem ou ponto final | Nenhum limite de taxa específico aplicado. |
| Taxa de Solicitação da Plataforma AWS (Compartilhada) | 10.000 solicitações/segundo (Compartilhada globalmente por todos os clientes). |
| Capacidade de Congestionamento da Plataforma AWS (Compartilhada) | 5.000 solicitações (Compartilhada globalmente por todos os clientes). |
⚠️ Aviso Crítico de Integração
Os limites compartilhados da plataforma mostrados acima não são cotas reservadas por cliente. Para evitar problemas de desempenho e proteger a estabilidade da plataforma, as integrações devem ser projetadas para uso responsável e eficiente dos recursos.
2. Autenticação OAuth e Gerenciamento de Tokens
O manuseio inadequado de tokens é uma causa comum de sobrecarga evitável da API. Estruture sua lógica de autenticação com base nas seguintes regras:
-
Duração do Token: Tokens de acesso são válidos por 24 horas (
expires_in = 86400). - Cache & Reutilização: Armazene em cache e reutilize os tokens de acesso durante toda a sua duração válida. Não gere um novo token para cada solicitação da API.
-
Renovação Proativa: Renove o token armazenado em cache pouco antes da expiração ou imediatamente após receber uma resposta
HTTP 401 Unauthorized. - Credenciais vs. Capacidade: Embora os administradores da conta possam criar várias credenciais OAuth, a utilização de várias credenciais não aumenta sua capacidade total da API.
3. Monitoramento da Frota e do Status do Dispositivo
Ao monitorar a saúde do dispositivo e implantações ativas em escala, otimize seu design de consulta para reduzir a sobrecarga da rede:
-
Auditorias de Status Rotineiras: Use pontos finais de consulta em massa—como
GET /devicesouPUT /devices/search—para recuperar registros de status de vários dispositivos em uma única chamada. Evite consultarGET /devices/{serial}individualmente para cada quiosque. - Intervalos de Consulta (Inativas): Para verificações de saúde e status de rotina, intervalos de consulta de a cada poucos minutos são suficientes.
-
Monitoramento de Implantação Ativa: Para rastrear instalações ativas, consulte
GET /device/{serial}/content/statusem um intervalo de 1 a 2 minutos. Pare de consultar uma vez que a implantação atinja um estado finalizado (Sucesso ou Falha).
4. Implantação de Aplicativos em Múltiplos Dispositivos
O ponto final POST /deployments suporta a direcionamento de muitos dispositivos simultaneamente.
- Formatos de Destinação: Especifique os destinatários em uma única carga útil de solicitação usando uma lista de números de série, grupos de dispositivos ou critérios de consulta.
- A Consulta de Destino Vazia: Deixar a consulta de destino em branco irá direcionar automaticamente todos os dispositivos na conta. Use este parâmetro com extremo cuidado.
- Restrições de Lote: Embora o ponto final não imponha um limite rígido de número de série, as cargas úteis continuam sujeitas à configuração de tamanho de lote de sua conta e às permissões de operação em lote da credencial OAuth.
-
Respostas Acima do Limite: Superar os limites da sua conta pode gerar um erro
400 BATCH_LIMIT_EXCEEDEDou exigir verificação manual sePENDING_FOR_APPROVALestiver configurado.
5. Concorrência, Erros da API e Novas Tentativas
As integrações devem manter um perfil de concorrência conservador. Mantenha as solicitações paralelas ativas limitadas a 5–10 conexões concorrentes. Utilize filas e processamento em lote para transmitir dados, em vez de executar milhares de pontos finais paralelos.
Respostas Comuns da API & Ações Recomendadas
| Status HTTP da API | Significado & Ação Recomendada |
|---|---|
| HTTP 401 Unauthorized | Falha de autenticação (por exemplo, token expirado ou revogado). Verifique as credenciais de autenticação e solicite um novo token. |
| HTTP 429 Too Many Requests | Estrangulamento da taxa da plataforma. Implemente a lógica de nova tentativa usando retardo exponencial com jitter aleatório. |
| 400 BATCH_LIMIT_EXCEEDED | O tamanho da carga útil excede os limites permitidos de execução em lote. Revise as configurações da conta e particione a transação. |
⚙️ Estratégia de Retardo para Lógica de Nova Tentativa
Ao lidar com respostas HTTP 429, configure seu cronograma de novas tentativas progressivamente (por exemplo, 1s, 2s, 4s, 8s, 16s, 32s, até um máximo de 60s) e aplique um atraso aleatório (jitter) para evitar inundações de serviço localizadas. Nota: O retorno da plataforma do cabeçalho 'Retry-After' não é confirmado.
6. Resolvendo Erros Inesperados da API
Se sua integração enfrentar interrupções persistentes, percorra esta lista rápida de verificação para solução de problemas:
-
Valide a URL Base: Confirme que você está chamando o gateway EloView 4 (
https://secure-api.eloview.com) e não um host legado do EloView 3. -
Verifique os Códigos de Status: Isolar problemas de autorização (
HTTP 401) de estrangulamento da infraestrutura (HTTP 429). - Revise Métricas Operacionais: Revise as durações de reutilização de tokens, frequências de consulta de quiosques individuais, utilização de pontos finais em massa e contagens de concorrência de threads ativas.
📞 Escalando para o Suporte Técnico
Se problemas inesperados da API persistirem, entre em contato com Elo Suporte Técnico. Para acelerar a investigação, forneça:
- URL base da API e ponto final específico chamado
- Seus endereços IP de saída públicos
- Carimbos de tempo exatos dos eventos (incluindo fuso horário)
- Códigos de status HTTP retornados e cargas úteis de resposta completas
Please report any broken links by emailing elo.support@zebra.com and include a link to the knowledge article