Document ID: KB-EV4-API-01 | Product/Dienst: EloView 4 REST API | Doelgroep: Integrators, Ontwikkelaars, Zakelijke Klanten
EloView 4 API Snelheidslimieten en Best Practices voor Integratie met Hoge Volumes
De EloView REST API stelt zakelijke klanten en integratiepartners in staat om programmatically apparaatinformatie op te halen, de gezondheid van de vloot te monitoren, content te beheren en applicaties te implementeren. Dit artikel beschrijft de snelheidslimieten van de EloView 4 API, authenticatiegedragingen en architecturale best practices voor betrouwbare, integraties met hoge volumes van de API.
💡 Snelle Overzicht
EloView 4 past geen individuele klant specifieke API-limieten toe. Voor optimale betrouwbaarheid moeten integraties OAuth-tokens cachen, bulk/multi-apparaatquery's verkiezen, gelijktijdige threads beperken en exponentiële terugval met jitter voor foutafhandeling implementeren.
1. EloView 4 API Snelheidslimieten
EloView 4 handhaaft geen snelheidslimieten per individuele OAuth-referentie, klantaccount, bron IP-adres of API-eindpunt. De basis-API URL voor productie is:
https://secure-api.eloview.com
| Parameter | Limiet / Capaciteit |
|---|---|
| Per credential, account, bron IP of endpoint | Geen specifieke snelheidslimieten toegepast. |
| AWS Platform Verzoekfrequentie (Gedeeld) | 10.000 verzoeken/per seconde (Gedeeld wereldwijd door alle klanten). |
| AWS Platform Burst Capaciteit (Gedeeld) | 5.000 verzoeken (Gedeeld wereldwijd door alle klanten). |
⚠️ Kritieke Integratie Waarschuwing
De hierboven weergegeven gedeelde platformlimieten zijn niet gereserveerde quotas per klant. Om prestatietekorten te voorkomen en de stabiliteit van het platform te beschermen, moeten integraties zijn ontworpen voor efficiënt en verantwoordelijk gebruik van bronnen.
2. OAuth Authenticatie en Tokenbeheer
Onjuiste tokenverwerking is een veelvoorkomende oorzaak van vermijdbare API-overhead. Gelieve uw authenticatielogica te structureren op basis van de volgende regels:
-
Token levensduur: Toegangstokens zijn geldig voor 24 uur (
expires_in = 86400). - Cachen & Hergebruiken: Cache en hergebruik toegangstokens voor hun volledige geldige levensduur. Genereer geen nieuw token voor elk API-verzoek.
-
Proactieve Vernieuwing: Vernieuw het gecachte token kort voor afloop, of onmiddellijk na een
HTTP 401 Unauthorizedreactie. - Referenties vs. Capaciteit: Hoewel accountbeheerders meerdere OAuth-referenties kunnen aanmaken, verhoogt het gebruik van meerdere referenties niet uw totale API-capaciteit.
3. Monitoring van Vloot en Apparaatstatus
Bij het monitoren van de gezondheid van apparaten en actieve implementaties op grote schaal, optimaliseer uw queryontwerp om netwerkoverhead te verminderen:
-
Routine Statusaudits: Gebruik bulk-query-eindpunten—zoals
GET /devicesofPUT /devices/search—om statusrecords voor meerdere apparaten in een enkele oproep op te halen. Vermijd omGET /devices/{serial}afzonderlijk voor elk kiosk te pingen. - Polling Intervallen (Inactief): Voor routinematige gezondheids- en statuscontroles zijn polling-intervallen van elke paar minuten voldoende.
-
Monitoring van Actieve Implementaties: Om actieve installaties bij te houden, query
GET /device/{serial}/content/statusmet een interval van 1 tot 2 minuten. Stop met pingen zodra de implementatie een afgeronde staat bereikt (Succes of Mislukking).
4. Applicatie-Implementaties naar Meerdere Apparaten
De POST /deployments eindpunt ondersteunt het tegelijkertijd richten op veel apparaten.
- Doelformaten: Geef de ontvangers op in een enkele verzoekpallet met een lijst van serienummers, apparaatsgroepen of zoekcriteria.
- De Lege Querydoel: Het blanco laten van het doelquery zal automatisch alle apparaten in het account targeten. Gebruik deze parameter met uiterste voorzichtigheid.
- Batchbeperkingen: Hoewel de eindpunt geen strikte limiet voor serienummers afdwingt, blijven payloads onderworpen aan de batch-grootteinstelling van uw account en de batch-bewerkingsrechten van de OAuth-referentie.
-
Over-Limiet Antwoorden: Het overschrijden van uw accountlimieten kan een
400 BATCH_LIMIT_EXCEEDEDfoutactiveren, of handmatige verificatie vereisen alsPENDING_FOR_APPROVALis geconfigureerd.
5. Gelijktijdigheid, API-fouten en Herhalingen
Integraties moeten een conservatief gelijktijdigheidsprofiel behouden. Houd actieve parallelle verzoeken beperkt tot 5–10 gelijktijdige verbindingen. Gebruik wachtrijen en batchverwerking om gegevens te streamen in plaats van duizenden parallelle eindpunten uit te voeren.
Veelvoorkomende API-antwoorden & Acties
| API HTTP Status | Betekenis & Aanbevolen Actie |
|---|---|
| HTTP 401 Unauthorized | Authenticatie fout (bijv. token verlopen of ingetrokken). Verifieer de authenticatie referenties en vraag een nieuw token aan. |
| HTTP 429 Te Veel Verzoeken | Platform snelheidsbeperking. Implementeer herhaalconditie met exponentiële terugval met gerandomiseerde jitter. |
| 400 BATCH_LIMIT_EXCEEDED | De payloadgrootte overschrijdt de toegestane batchuitvoeringslimieten. Controleer de accountinstellingen en verdeel de transactie. |
⚙️ Herhaal Logica Terugval Strategie
Bij het omgaan met HTTP 429 antwoorden, configureer uw herhaalprogramma progressief (bijv. 1s, 2s, 4s, 8s, 16s, 32s, tot 60s max) en pas een gerandomiseerde vertraging (jitter) toe om lokale serviceoverstromingen te voorkomen. Opmerking: De platformterugkeer van de 'Retry-After' header is niet bevestigd.
6. Probleemoplossing van Onverwachte API-fouten
Als uw integratie aanhoudende onderbrekingen ervaart, doorloop dan deze snelle probleemoplossingschecklist:
-
Valideer de Basis URL: Bevestig dat u de EloView 4 gateway aanroept (
https://secure-api.eloview.com) en niet een legacy EloView 3 host. -
Verifieer Statuscodes: Isolateer autorisatieproblemen (
HTTP 401) van infrastructuurbeperkingen (HTTP 429). - Herzien Operationele Statistieken: Bezie de levensduur van hergebruik van tokens, afzonderlijke kioskpollingfrequenties, gebruik van bulk-eindpunten en actieve draadgelijktijdigheidsaantallen.
📞 Escaleren naar Technische Ondersteuning
Als onverwachte API-problemen aanhouden, neem dan contact op met Elo Technische Ondersteuning. Om het onderzoek te versnellen, gelieve te voorzien in:
- API Basis URL en specifiek aangeroepen eindpunt
- Uw openbaar-uitgaande bron IP-adressen
- Precieze tijdstempels van evenementen (inclusief tijdzone)
- Geretourneerde HTTP-statuscodes en complete responspayloads
Please report any broken links by emailing elo.support@zebra.com and include a link to the knowledge article