API erişimi eklentisiyle ekranlarınızı, playlistlerinizi, zamanlamanızı ve raporlarınızı kendi sistemlerinizden yönetirsiniz: ERP’deki fiyat değişince menü görseli güncellenir, kampanya aracı yeni afişi yükleyip yayına alır, iş zekâsı aracınız oynatma raporunu her gece çeker. Eklenti V-Premium paketine dahildir; diğer paketlerde Eklentiler sayfasından açılır.
Teknik ayrıntılar (uçlar, örnek kodlar) geliştirici belgelerindedir: developers.viswoo.com/api. Bu sayfa panel tarafını anlatır.
Anahtar oluşturma
- Eklentiler → API erişimi sayfasını açın. Anahtarları yalnız hesap sahibi ve yöneticiler yönetir.
- Anahtar oluştur’a basın; anahtarı kullanacak sistemin adını yazın (ör. “ERP”).
- Yalnız gereken izinleri seçin. Ör. fiyat ekranlarını güncelleyen bir sistem için İçeriği yönetme yeterlidir.
- Geçerlilik süresini seçin (90 gün, 1 yıl ya da süresiz) ve Oluştur’a basın.
- Anahtarı hemen kopyalayıp entegrasyonu yapan kişiye güvenli bir yoldan iletin. Anahtar bir daha gösterilmez.
Anahtar kişiye değil işletmenize aittir: oluşturan kişi ekipten ayrılsa da çalışır. Kullanılmayan ya da sızdığından şüphelendiğiniz anahtarı İptal et ile hemen kapatın.
İzinler
| İzin | Ne yapabilir |
|---|---|
| Ekranları okuma | Şubeleri, ekranları, canlı durumu ve ekran görüntüsünü görür |
| Ekranları yönetme | Ekran ayarlarını değiştirir, ekranı yeniler ya da yeniden başlatır |
| İçeriği okuma | Medyayı, playlistleri ve zamanlamayı görür |
| İçeriği yönetme | Medya yükler, playlist ve zamanlamayı değiştirir, acil duyuru gönderir |
| Raporları okuma | Oynatma ve çalışma süresi raporlarını alır (Raporlar eklentisi de gerekir) |
| Webhook yönetimi | Olay bildirim adreslerini yönetir |
Anahtarla yapılan değişiklikler yöneticinin yaptığı gibi hemen yayına çıkar ve denetim kaydında “API: anahtar adı” olarak görünür.
Webhooklar
Webhook, bir olay olduğunda Viswoo’nun sizin sunucunuza haber vermesidir: ekran çevrimdışı oldu, yeniden bağlandı, yüklenen medya işlendi, onay bekleyen bir değişiklik var. Aynı sayfadaki Webhooklar bölümünden:
- Adres ekle’ye basın, https ile başlayan adresi yazın ve olayları seçin.
- Gösterilen imza sırrını kopyalayıp sunucunuza kaydedin; Viswoo’dan gelen isteği bununla doğrularsınız.
- Deneme gönder ile bağlantıyı deneyin; Teslimler son 7 günün kaydını gösterir.
Sunucunuz cevap vermezse Viswoo yaklaşık 24 saat boyunca yeniden dener. Bir adres art arda çok kez başarısız olursa durdurulur ve size e-posta gelir; sorunu giderip adresi Düzenle ile yeniden açın.
Sık sorulanlar
Anahtarı kaybettim. Gösterilmez, kurtarılamaz. Yeni bir anahtar oluşturup eskisini iptal edin.
İstek sınırı var mı? Anahtar başına dakikada 120 istek. Normal entegrasyonlar bu sınıra yaklaşmaz.
Eklentiyi kapatırsam ne olur? Anahtarlar silinmez ama çalışmaz; eklentiyi yeniden açınca kaldığı yerden devam eder.
Sorunuz mu var? Bize yazın