Webhooklar

Webhooklar

Webhooklar, önemli bir şey olduğunda GoVista'nın sistemlerinize gerçek zamanlı olay bildirimleri göndermesini sağlar.

Webhooklar Nedir?

Değişiklikleri kontrol etmek için API'yi sorgulamak yerine, webhooklar olaylar meydana geldiğinde sunucunuza HTTP POST istekleri gönderir.

Mevcut Olaylar

Cihaz Olayları:

• device.online — Cihaz çevrimiçi oldu
• device.offline — Cihaz çevrimdışı oldu
• device.paired — Yeni cihaz eşleştirildi
• device.removed — Cihaz kaldırıldı
• device.alert — Cihaz uyarısı tetiklendi

İçerik Olayları:

• content.uploaded — Yeni içerik yüklendi
• content.deleted — İçerik silindi
• content.approved — İçerik onaylandı
• content.rejected — İçerik reddedildi

Playlist Olayları:

• playlist.created — Yeni playlist oluşturuldu
• playlist.deployed — Playlist cihazlara dağıtıldı
• playlist.updated — Playlist değiştirildi

Zamanlama Olayları:

• schedule.activated — Zamanlama aktif oldu
• schedule.deactivated — Zamanlama devre dışı bırakıldı

Webhook Oluşturma

1. Ayarlar > API > Webhooklar bölümüne gidin 2. Webhook Oluştur butonuna tıklayın 3. Uç nokta URL'sini girin (HTTPS olmalıdır) 4. Almak istediğiniz olayları seçin 5. İsteğe bağlı olarak imza doğrulaması için gizli anahtar ekleyin 6. Kaydedin ve etkinleştirin

Webhook Yükü

``json { "event": "device.offline", "timestamp": "2025-01-15T10:30:00Z", "data": { "device_id": "dev_abc123", "device_name": "Lobi Ekranı 1", "store": "İstanbul Merkez", "last_heartbeat": "2025-01-15T10:25:00Z" } } ``

İmza Doğrulaması

Gizli anahtar ayarlarsanız, GoVista X-GoVista-Signature başlığında bir HMAC-SHA256 imzası ekler. Webhook'un GoVista'dan geldiğinden emin olmak için bu imzayı doğrulayın.

Yeniden Deneme Mantığı

Uç noktanız 2xx dışı bir durum kodu döndürürse:

• GoVista en fazla 5 kez yeniden dener
• Yeniden deneme aralıkları: 1 dk, 5 dk, 30 dk, 2 saat, 12 saat
• Tüm yeniden denemeler başarısız olursa webhook başarısız olarak işaretlenir

Webhook Günlükleri

Her webhook için teslim geçmişini görüntüleyin:

• Gönderilen yük
• Alınan yanıt
• Durum kodu
• Yeniden deneme girişimleri