Cihazlar API

5 dk okuma

Cihazlar API

Cihazlar API ile cihazlarınızı programatik olarak yönetin.

Cihazları Listele

`` GET /v1/devices ``

Sorgu parametreleri:

  • page — Sayfa numarası (varsayılan: 1)
  • limit — Sayfa başına öğe (varsayılan: 20, maks: 100)
  • status — Duruma göre filtre: online, offline
  • store_id — Mağazaya göre filtre
  • tag — Etikete göre filtre

Yanıt: ``json { "success": true, "data": [ { "id": "dev_abc123", "name": "Lobi Ekranı 1", "status": "online", "type": "TV", "platform": "android", "store_id": "store_xyz", "last_heartbeat": "2025-01-15T10:30:00Z", "player_version": "1.5.67", "tags": ["lobi", "karsilama"] } ] } ``

Cihaz Detayı

`` GET /v1/devices/:id ``

Donanım metrikleri, mevcut playlist ve yapılandırma dahil tam cihaz bilgisini döndürür.

Cihaz Güncelleme

`` PATCH /v1/devices/:id ``

İstek gövdesi: ``json { "name": "Güncellenmiş Ad", "store_id": "store_yeni", "tags": ["guncel-etiket"], "orientation": "portrait" } ``

Komut Gönderme

`` POST /v1/devices/:id/commands ``

İstek gövdesi: ``json { "command": "REFRESH" } ``

Mevcut komutlar: REFRESH, REBOOT, APP_RESTART, UPDATE_CHECK

Otomatik izleme betikleri için çevrimdışı cihazları hızla belirlemek amacıyla status filtresini kullanın.

Cihaz Silme

`` DELETE /v1/devices/:id ``

Cihazı organizasyonunuzdan kaldırır. Fiziksel cihazın yeniden eşleştirilmesi gerekecektir.

Cihaz Kalp Atışı Verileri

`` GET /v1/devices/:id/heartbeats ``

Sorgu parametreleri:

  • from — Başlangıç tarihi (ISO 8601)
  • to — Bitiş tarihi (ISO 8601)
  • interval — Toplama aralığı: minute, hour, day

CPU, bellek, disk, sıcaklık ve Wi-Fi sinyali dahil geçmiş kalp atışı verilerini döndürür.

DELETE uç noktası bir cihazı kalıcı olarak kaldırır. Bu işlem geri alınamaz. Cihaz eşleştirme ekranını gösterir ve yeniden eşleştirilmesi gerekir.

Bu makale yardımcı oldu mu?