Dokument ID: KB-EV4-API-01 | Produkt/Dienst: EloView 4 REST API | Zielgruppe: Integratoren, Entwickler, Unternehmenskunden
EloView 4 API Ratenlimits und Best Practices für Integrationen mit hohem Volumen
Die EloView REST API ermöglicht es Unternehmenskunden und Integrationspartnern, programmgesteuert Gerätinformationen abzurufen, die Flottengesundheit zu überwachen, Inhalte zu verwalten und Anwendungen bereitzustellen. Dieser Artikel beschreibt die Ratenlimits der EloView 4 API, Authentifizierungsverhalten und architektonische Best Practices für zuverlässige, integrations mit hohem Volumen.
💡 Kurzübersicht
EloView 4 wendet keine individuellen, kundenspezifischen API-Limits an. Für optimale Zuverlässigkeit sollten Integrationen OAuth-Token zwischenspeichern, Bulk-/Mehrgeräteabfragen bevorzugen, gleichzeitige Threads begrenzen und exponentielles Backoff mit Jitter zur Fehlerbehandlung implementieren.
1. EloView 4 API Ratenlimits
EloView 4 setzt keine Ratenlimits pro individuelle OAuth-Anmeldeinformationen, Kundenkonto, Quell-IP-Adresse oder API-Endpunkt durch. Die Basis-URL der Produktions-API ist:
https://secure-api.eloview.com
| Parameter | Limit / Kapazität |
|---|---|
| Pro Anmeldeinformation, Konto, Quell-IP oder Endpunkt | Es gelten keine spezifischen Ratenlimits. |
| AWS Plattform-Anforderungsrate (Geteilt) | 10.000 Anfragen/Sekunde (global von allen Kunden geteilt). |
| AWS Plattform-Spitzenkapazität (Geteilt) | 5.000 Anfragen (global von allen Kunden geteilt). |
⚠️ Kritische Integrationswarnung
Die oben genannten Shared-Plattformlimits sind keine pro Kunde reservierten Quoten. Um Leistungsprobleme zu vermeiden und die Stabilität der Plattform zu schützen, müssen Integrationen so gestaltet sein, dass sie Ressourcen effizient und verantwortungsvoll nutzen.
2. OAuth-Authentifizierung und Token-Management
Unsachgemäße Token-Verwaltung ist eine häufige Ursache für vermeidbare API-Überlastungen. Bitte gestalten Sie Ihre Authentifizierungslogik basierend auf den folgenden Regeln:
-
Token-Lebensdauer: Zugriffstoken sind für 24 Stunden gültig (
expires_in = 86400). - Zwischenspeicherung & Wiederverwendung: Zwischenspeichern und Wiederverwenden Sie Zugriffstoken während ihrer gesamten Gültigkeitsdauer. Generieren Sie kein neues Token für jede API-Anfrage.
-
Proaktive Erneuerung: Erneuern Sie das zwischengespeicherte Token kurz vor dem Ablauf oder sofort nach Erhalt einer
HTTP 401 Unauthorized-Antwort. - Anmeldeinformationen vs. Kapazität: Obwohl Kontoadministratoren mehrere OAuth-Anmeldeinformationen erstellen können, erhöht die Nutzung mehrerer Anmeldeinformationen nicht Ihre gesamte API-Kapazität.
3. Überwachung der Flotte und des Gerätestatus
Bei der Überwachung der Gerätegesundheit und aktiven Bereitstellungen im großen Maßstab sollten Sie Ihr Abfragedesign optimieren, um Netzwerküberlastungen zu reduzieren:
-
Routine-Statusprüfungen: Verwenden Sie Bulk-Abfrageendpunkte — wie
GET /devicesoderPUT /devices/search— um Statusdaten für mehrere Geräte in einem einzigen Aufruf abzurufen. Vermeiden Sie es,GET /devices/{serial}individuell für jeden Kiosk zu polling. - Polling-Intervalle (Leerlauf): Für routinemäßige Gesundheits- und Statusprüfungen sind Polling-Intervalle von einigen Minuten ausreichend.
-
Überwachung aktiver Bereitstellungen: Um aktive Installationen zu verfolgen, führen Sie die Abfrage
GET /device/{serial}/content/statusin einem Intervall von 1 bis 2 Minuten durch. Hören Sie auf zu polling, sobald die Bereitstellung einen endgültigen Status erreicht (Erfolg oder Misserfolg).
4. Anwendungsbereitstellungen auf mehrere Geräte
Der POST /deployments-Endpunkt unterstützt das gleichzeitige Anvisieren mehrerer Geräte.
- Zielformate: Geben Sie Empfänger in einem einzigen Anforderungs-Payload an, indem Sie eine Liste von Seriennummern, Gerätegruppen oder Abfragekriterien verwenden.
- Das leere Abfrageziel: Wenn Sie die Zielabfrage leer lassen, werden automatisch alle Geräte im Konto angevisiert. Verwenden Sie diesen Parameter mit äußerster Vorsicht.
- Batch-Einschränkungen: Obwohl der Endpunkt kein striktes Limit für Seriennummern durchsetzt, unterliegen Payloads den Batch-Größeinstellungen Ihres Kontos und den Berechtigungen für Batch-Operationen der OAuth-Anmeldeinformationen.
-
Überlimit-Antworten: Das Überschreiten der Kontolimits kann einen
400 BATCH_LIMIT_EXCEEDED-Fehler auslösen oder eine manuelle Überprüfung erfordern, wennPENDING_FOR_APPROVALkonfiguriert ist.
5. Parallelität, API-Fehler und Wiederholungen
Integrationen sollten ein konservatives Parallelitätsprofil aufrechterhalten. Halten Sie aktive parallele Anfragen auf 5–10 gleichzeitige Verbindungen beschränkt. Verwenden Sie Warteschlangen und Batch-Verarbeitung, um Daten zu übertragen, anstatt Tausende paralleler Endpunkte auszuführen.
Häufige API-Antworten & Aktionen
| API HTTP-Status | Bedeutung & Empfohlene Aktion |
|---|---|
| HTTP 401 Unauthorized | Authentifizierungsfehler (z.B. Token abgelaufen oder widerrufen). Überprüfen Sie die Authentifizierungsanmeldeinformationen und fordern Sie ein neues Token an. |
| HTTP 429 Too Many Requests | Drosselung der Plattformrate. Implementieren Sie eine Wiederholungslogik mit exponentiellem Backoff mit zufälligem Jitter. |
| 400 BATCH_LIMIT_EXCEEDED | Die Payload-Größe überschreitet die zulässigen Limits der Batch-Ausführung. Überprüfen Sie die Kontoeinstellungen und partitionieren Sie die Transaktion. |
⚙️ Wiederholungslogik-Backoff-Strategie
Bei der Verarbeitung von HTTP 429-Antworten konfigurieren Sie Ihren Wiederholungszeitplan schrittweise (z.B. 1s, 2s, 4s, 8s, 16s, 32s, maximal 60s) und wenden Sie eine zufällige Verzögerung (Jitter) an, um lokale Dienstüberflutungen zu verhindern. Hinweis: Die Rückgabe des 'Retry-After'-Headers von der Plattform ist unbestätigt.
6. Fehlersuche bei unerwarteten API-Fehlern
Wenn Ihre Integration anhaltende Störungen erlebt, gehen Sie diese schnelle Fehlersuche-Checkliste durch:
-
Die Basis-URL validieren: Bestätigen Sie, dass Sie das EloView 4-Gateway (
https://secure-api.eloview.com) und nicht einen Legacy-EloView 3-Host aufrufen. -
Statuscodes überprüfen: Isolieren Sie Autorisierungsprobleme (
HTTP 401) von Infrastruktur-Drosselung (HTTP 429). - Überprüfen der Betriebsmetriken: Überprüfen Sie die Lebensdauer der Token-Wiederverwendung, die Polling-Frequenzen der einzelnen Kioske, die Nutzung von Bulk-Endpunkten und die aktiven Thread-Kapazitäten.
📞 Eskalation an den technischen Support
Wenn unerwartete API-Probleme weiterhin bestehen, kontaktieren Sie Elo Technischen Support. Um die Untersuchung zu beschleunigen, geben Sie bitte an:
- API Basis-URL und spezifischen aufgerufenen Endpunkt
- Ihre öffentlich sichtbaren ausgehenden Quell-IP-Adressen
- Genaue Zeitstempel der Ereignisse (einschließlich Zeitzone)
- Zurückgegebene HTTP-Statuscodes und vollständige Antwortpayloads
Please report any broken links by emailing elo.support@zebra.com and include a link to the knowledge article