Belge ID: KB-EV4-API-01 | Ürün/Hizmet: EloView 4 REST API | Hedef Kitle: Entegratörler, Geliştiriciler, Kurumsal Müşteriler
EloView 4 API Hız Sınırları ve Yüksek Hacimli Entegrasyon En İyi Uygulamaları
EloView REST API, kurumsal müşteriler ve entegrasyon ortaklarının cihaz bilgilerini programlı olarak almasını, filo sağlığını izlemesini, içeriği yönetmesini ve uygulamaları dağıtmasını sağlar. Bu makalede, EloView 4 API hız sınırları, kimlik doğrulama davranışları ve güvenilir, yüksek hacimli API entegrasyonları için mimari en iyi uygulamalar belirtilmiştir.
💡 Hızlı Genel Bakış
EloView 4, bireysel müşteri spesifik API limitlerini uygulamaz. Optimal güvenilirlik için, entegrasyonlar OAuth token'lerini önbelleklemesi, toplu/multi-cihaz sorgularını tercih etmesi, eş zamanlı iş parçacıklarını sınırlaması ve hata yönetimi için jitter ile üstel geri dönüşü uygulaması gerekmektedir.
1. EloView 4 API Hız Sınırları
EloView 4, bireysel OAuth kimlik bilgisine, müşteri hesabına, kaynak IP adresine veya API noktasına göre hız sınırları uygulamaz. Üretim API temel URL'si:
https://secure-api.eloview.com
| Parametre | Limit / Kapasite |
|---|---|
| Bireysel kimlik bilgisi, hesap, kaynak IP veya uç nokta başına | Belirli bir hız sınırı uygulanmamıştır. |
| AWS Platform İstek Hızı (Paylaşılan) | 10,000 istek/saniye (Tüm müşteriler tarafından küresel olarak paylaşılan). |
| AWS Platform Patlama Kapasitesi (Paylaşılan) | 5,000 istek (Tüm müşteriler tarafından küresel olarak paylaşılan). |
⚠️ Kritik Entegrasyon Uyarısı
Yukarıda gösterilen paylaşılan platform limitleri her müşteri için ayrılmış kontenjanlar değildir. Performans sorunlarını önlemek ve platform stabilitesini korumak için entegrasyonlar, verimli ve sorumlu kaynak kullanımı için tasarlanmalıdır.
2. OAuth Kimlik Doğrulama ve Token Yönetimi
Yanlış token yönetimi, önlenebilir API yükünün yaygın bir nedenidir. Lütfen kimlik doğrulama mantığınızı aşağıdaki kurallara göre yapılandırın:
-
Token Süresi: Erişim token'leri 24 saat geçerlidir (
expires_in = 86400). - Önbellek ve Yeniden Kullanım: Erişim token'lerini geçerlilik süresi boyunca önbellekle ve yeniden kullan. Her API isteği için yeni bir token oluşturma.
-
Proaktif Yenileme: Önbellekteki token'i sona ermeden hemen önce yenileyin veya
HTTP 401 Yetkisizyanıtını aldığınızda hemen yenileyin. - Kimlik Bilgileri vs. Kapasite: Hesap yöneticileri birden fazla OAuth kimlik bilgisi oluşturabilse de, birden fazla kimlik bilgisi kullanmak genel API kapasitenizi arttırmaz.
3. Filo ve Cihaz Durumunu İzleme
Aktif dağıtımları ve cihaz sağlığını ölçekli olarak izlerken, ağ yükünü azaltmak için sorgu tasarımınızı optimize edin:
-
Rutin Durum Denetimleri: Bir çağrıda birden fazla cihaz için durum kayıtlarını alınmak üzere toplu sorgu uç noktalarını kullanın—örneğin
GET /devicesveyaPUT /devices/search. Her kiosk için bireysel olarakGET /devices/{serial}sorgusu yapmaktan kaçının. - Polling Aralıkları (Boşta): Rutin sağlık ve durum kontrolleri için, her birkaç dakikada bir sorgulama aralıkları yeterlidir.
-
Aktif Dağıtım İzleme: Aktif kurulumları takip etmek için,
GET /device/{serial}/content/statussorgusunu 1 ila 2 dakika aralıklarla sorgulayın. Dağıtım nihai bir duruma (Başarılı veya Başarısız) ulaştığında sorgulamayı durdurun.
4. Birden Fazla Cihaza Uygulama Dağıtımı
POST /deployments uç noktası, birçok cihazı aynı anda hedeflemeyi destekler.
- Hedefleme Biçimleri: Alıcıları tek bir istek yükünde, seri numaraları, cihaz grupları veya sorgu kriterleri listesi kullanarak belirtin.
- Boş Sorgu Hedefi: Hedef sorgusunu boş bırakırsanız, hesaptaki tüm cihazları otomatik olarak hedefleyecektir. Bu parametreyi son derece dikkatli kullanın.
- Toplu Kısıtlamalar: Uç nokta katı bir seri numarası limiti uygulamasa da, yükler hesabınızın parti boyutu ayarına ve OAuth kimliğinin parti işlemleri izinlerine tabi kalır.
-
Limit Aşımı Yanıtları: Hesap limitlerinizi aşmak,
400 BATCH_LIMIT_EXCEEDEDhatasını tetikleyebilir veyaPENDING_FOR_APPROVALyapılandırıldığında manuel doğrulamayı gerektirebilir.
5. Eş Zamanlılık, API Hataları ve Yeniden Denemeler
Entegrasyonlar, muhafazakar bir eş zamanlılık profili sürdürmelidir. Aktif paralel istekleri 5-10 eş zamanlı bağlantı ile sınırlı tutun. Verileri akıtmak için kuyrukları ve toplu işlemleri kullanarak binlerce paralel uç nokta çalıştırmaktan kaçının.
Yaygın API Yanıtları & Eylemler
| API HTTP Durumu | Anlamı & Önerilen Eylem |
|---|---|
| HTTP 401 Yetkisiz | Kimlik doğrulama hatası (örn., token süresi dolmuş veya iptal edilmiş). Kimlik doğrulama bilgilerini kontrol edin ve yeni bir token talep edin. |
| HTTP 429 Çok Fazla İstek | Platform hız sınırlaması. Rastgele jitter ile üstel geri dönüş kullanarak yeniden deneme mantığı uygulayın. |
| 400 BATCH_LIMIT_EXCEEDED | Yük boyutu izin verilen toplu yürütme limitlerini aşmaktadır. Hesap ayarlarını gözden geçirin ve işlemi bölümlendirin. |
⚙️ Yeniden Deneme Mantığı Geri Dönüş Stratejisi
HTTP 429 yanıtlarını ele alırken, yeniden deneme programınızı aşamalı olarak yapılandırın (örn., 1sn, 2sn, 4sn, 8sn, 16sn, 32sn, maksimum 60sn) ve yerel hizmet sel baskınlarını önlemek için rastgele bir gecikme (jitter) uygulayın. Not: Platformun 'Retry-After' başlığını döndüreceği doğrulanmamıştır.
6. Beklenmeyen API Hatalarını Giderme
Entegrasyonunuz sürekli kesintiler yaşıyorsa, bu hızlı sorun giderme kontrol listesine göz atın:
-
Temel URL'yi Doğrulayın: EloView 4 geçidini (
https://secure-api.eloview.com) çağırdığınızdan emin olun ve eski bir EloView 3 sunucusu çağırmadığınızdan emin olun. -
Durum Kodlarını Doğrulayın: Yetkilendirme sorunlarını (
HTTP 401) altyapı yavaşlatmalarından (HTTP 429) ayırın. - Operasyonel Metrikleri Gözden Geçirin: Token yeniden kullanım sürelerini, bireysel kiosk sorgulama sıklıklarını, toplu uç noktaların kullanımını ve aktif iş parçacığı eş zamanlılık sayılarını gözden geçirin.
📞 Teknik Destekle İletişim
Eğer beklenmeyen API sorunları devam ederse, Elo Teknik Destek ile iletişime geçin. Araştırmayı hızlandırmak için, lütfen aşağıdakileri sağlayın:
- API Temel URL'si ve çağrılan spesifik uç nokta
- Halka açık müşteri kaynak IP adresleriniz
- Kesin olay zaman damgaları (zaman dilimi dahil)
- Dönen HTTP durum kodları ve tam yanıt yükleri
Please report any broken links by emailing elo.support@zebra.com and include a link to the knowledge article