ID du document : KB-EV4-API-01 | Produit/Service : API REST EloView 4 | Public : Intégrateurs, Développeurs, Clients Entreprises
Limites de taux de l'API EloView 4 et bonnes pratiques d'intégration à volume élevé
L'API REST EloView permet aux clients d'entreprise et aux partenaires d'intégration de récupérer des informations sur les appareils, de surveiller la santé de la flotte, de gérer le contenu et de déployer des applications de manière programmatique. Cet article décrit les limites de taux de l'API EloView 4, les comportements d'authentification et les meilleures pratiques architecturales pour des intégrations API fiables et à fort volume.
💡 Aperçu Rapide
EloView 4 n'applique pas de limites API spécifiques à chaque client. Pour une fiabilité optimale, les intégrations doivent mettre en cache les jetons OAuth, privilégier les requêtes par lot/multi-appareil, limiter les fils d'exécution concurrents et mettre en œuvre un retour exponentiel avec jitter pour la gestion des erreurs.
1. Limites de taux de l'API EloView 4
EloView 4 n'applique pas de limites de taux par crédentiel OAuth individuel, compte client, adresse IP source ou point final API. L'URL de base de l'API de production est :
https://secure-api.eloview.com
| Paramètre | Limite / Capacité |
|---|---|
| Par crédentiel, compte, IP source ou point final | Aucune limite de taux spécifique appliquée. |
| Taux de demande de plateforme AWS (Partagée) | 10 000 demandes/seconde (Partagée globalement par tous les clients). |
| Capacité d'augmentation de la plateforme AWS (Partagée) | 5 000 demandes (Partagée globalement par tous les clients). |
⚠️ Avertissement d'intégration critique
Les limites de plateforme partagées indiquées ci-dessus ne sont pas des quotas réservés par client. Pour éviter des problèmes de performance et protéger la stabilité de la plateforme, les intégrations doivent être conçues pour une utilisation efficace et responsable des ressources.
2. Authentification OAuth et gestion des jetons
Une mauvaise gestion des jetons est une cause courante de surcharge API évitable. Veuillez structurer votre logique d'authentification selon les règles suivantes :
-
Durée de vie du jeton : Les jetons d'accès sont valides pendant 24 heures (
expires_in = 86400). - Mise en cache et réutilisation : Mettez en cache et réutilisez les jetons d'accès pendant toute leur durée de vie valide. Ne générez pas un nouveau jeton pour chaque demande API.
-
Renouvellement proactif : Renouvelez le jeton mis en cache peu avant son expiration, ou immédiatement après avoir reçu une réponse
HTTP 401 Unauthorized. - Crédentiels vs Capacité : Bien que les administrateurs de compte puissent créer plusieurs crédentiels OAuth, l'utilisation de plusieurs crédentiels n'augmente pas votre capacité API globale.
3. Surveillance de la santé de la flotte et de l'état des appareils
Lors de la surveillance de la santé des appareils et des déploiements actifs à grande échelle, optimisez la conception de vos requêtes pour réduire la surcharge réseau :
-
Audits d'état de routine : Utilisez des points de terminaison de requête groupés—comme
GET /devicesouPUT /devices/search—pour récupérer des enregistrements d'état pour plusieurs appareils en un seul appel. Évitez de sonderGET /devices/{serial}individuellement pour chaque kiosque. - Intervalles de sondage (Inactif) : Pour les vérifications de santé et d'état de routine, des intervalles de sondage de quelques minutes sont suffisants.
-
Surveillance des déploiements actifs : Pour suivre les installations actives, interrogez
GET /device/{serial}/content/statusà un intervalle de 1 à 2 minutes. Arrêtez de sonder une fois que le déploiement atteint un état finalisé (Succès ou Échec).
4. Déploiements d'applications sur plusieurs appareils
Le point de terminaison POST /deployments prend en charge le ciblage de plusieurs appareils simultanément.
- Formats de ciblage : Spécifiez les destinataires dans une seule charge utile de requête en utilisant une liste de numéros de série, de groupes d'appareils ou de critères de requête.
- Le ciblage de requête vide : Laisser le ciblage de requête vide ciblera automatiquement tous les appareils du compte. Utilisez ce paramètre avec une extrême prudence.
- Restrictions de lot : Bien que le point de terminaison n'impose pas de limite stricte par numéro de série, les charges utiles demeurent soumises à la configuration de taille de lot de votre compte et aux autorisations d'opération par lot du crédentiel OAuth.
-
Réponses en cas de dépassement de limite : Dépasser vos limites de compte peut déclencher une erreur
400 BATCH_LIMIT_EXCEEDED, ou nécessiter une vérification manuelle siPENDING_FOR_APPROVALest configuré.
5. Concurrence, erreurs API et réessais
Les intégrations doivent maintenir un profil de concurrence conservateur. Limitez les demandes parallèles actives à 5–10 connexions concurrentes. Utilisez des files d'attente et un traitement par lot pour diffuser les données plutôt que d'exécuter des milliers de points de terminaison parallèles.
Réponses & Actions API courantes
| Statut HTTP API | Signification & Action recommandée |
|---|---|
| HTTP 401 Unauthorized | Échec de l'authentification (par exemple, jeton expiré ou révoqué). Vérifiez les informations d'identification d'authentification et demandez un nouveau jeton. |
| HTTP 429 Too Many Requests | Limitation de taux de la plateforme. Mettez en œuvre une logique de réessai en utilisant un retour exponentiel avec jitter randomisé. |
| 400 BATCH_LIMIT_EXCEEDED | La taille de la charge utile dépasse les limites d'exécution par lot permises. Vérifiez les paramètres du compte et divisez la transaction. |
⚙️ Stratégie de retour pour la logique de réessai
Lors de la gestion des réponses HTTP 429, configurez votre calendrier de réessai de manière progressive (par exemple, 1s, 2s, 4s, 8s, 16s, 32s, jusqu'à 60s max) et appliquez un délai randomisé (jitter) pour éviter les inondations de service localisées. Remarque : Le retour de la plateforme de l'en-tête 'Retry-After' n'est pas confirmé.
6. Résolution des erreurs API inattendues
Si votre intégration rencontre des interruptions persistantes, passez en revue cette liste de vérification rapide pour le dépannage :
-
Validez l'URL de base : Confirmez que vous appelez la passerelle EloView 4 (
https://secure-api.eloview.com) et non un hôte EloView 3 ancien. -
Vérifiez les codes d'état : Isolez les problèmes d'autorisation (
HTTP 401) de la limitation d'infrastructure (HTTP 429). - Examinez les indicateurs opérationnels : Vérifiez les durées de réutilisation des jetons, les fréquences de sondage de chaque kiosque, l'utilisation des points de terminaison groupés, et les comptes de concurrence des fils actifs.
📞 Élévation vers le support technique
Si des problèmes API inattendus persistent, contactez le support technique Elo. Pour accélérer l'enquête, veuillez fournir :
- URL de base API et point de terminaison spécifique appelé
- Vos adresses IP publiques sortantes
- Horodatages des événements précis (y compris le fuseau horaire)
- Codes de statut HTTP renvoyés et charges utiles de réponse complètes
Please report any broken links by emailing elo.support@zebra.com and include a link to the knowledge article