Anahtar oluşturun
Entegrasyonunuza bir ad verin ve ihtiyaç duyduğu izinleri seçin.
PERASIGNAGE DEVELOPERSEkranlarınız,
Ekranlarınız,
kendi yazılımınızda.
Ekranlarınızı uygulamanıza bağlayın; medyaları ve yayınları API ile yönetin.
Her entegrasyona ayrı anahtar, her anahtara doğru izin.
GET /v1/screens
Authorization: Bearer …
{
"data": [
{
"name": "Vitrin ekranı",
"connectionState": "online"
}
]
}BAĞLANTILARINIZ
API anahtarları —
Hesabınıza erişebilen entegrasyonları buradan yönetin.
Hesabınız kontrol ediliyor
API anahtarlarınız birazdan burada görünecek.
Anahtar yönetimi hesap sahibi ve yöneticilere açıktır. Yazma izinleri seçildiğinde entegrasyonunuz medya yükleyebilir, playlist düzenleyebilir ve seçtiğiniz ekranlara yayın gönderebilir.
İLK BAĞLANTI
Üç adımda başlayın
İstekleri kendi sunucunuzdan HTTPS üzerinden gönderin.
Güvenli yerde saklayın
Anahtarı sunucunuzun ortam değişkenine kaydedin. Tarayıcı koduna veya Git’e eklemeyin.
Ekranları sorgulayın
Authorization başlığıyla bağlanın. Sonraki sayfa için yanıttaki nextCursor değerini kullanın.
cURL · Ekranları listele
curl 'https://api.perasignage.com/v1/screens?limit=50' \ -H "Authorization: Bearer $PERASIGNAGE_API_KEY"
API V1
OpenAPI indir ↓Kullanılabilir uçlar
GET
/v1/meAnahtarın organizasyonu, izinleri ve geçerlilik süresi
GET
/v1/screensEkran listesi · screens:read
GET
/v1/screens/{id}Tek ekranın son bildirilen durumu · screens:read
GET
/v1/screen-groupsGrup listesi ve ekran sayıları · screen-groups:read
GET
/v1/screen-groups/{id}Tek grubun özeti · screen-groups:read
GET
/v1/mediaMevcut medya listesi · media:read
POST
/v1/mediaDosya yükle · En fazla 50 MiB · media:write
GET
/v1/playlistsPlaylist listesi · playlists:read
POST
/v1/playlistsPlaylist oluştur · playlists:write
PUT
/v1/playlists/{id}Başlık veya öğeleri düzenle · playlists:write
POST
/v1/playlists/{id}/publishSeçilen ekranlara yayın gönder · publications:write
GET
/v1/priority-broadcastsTanımlar ve görsel hazırlığı · priority:write
POST
/v1/priority-broadcasts/{id}/triggerSüreli görseli tetikle · priority:write
GET
/v1/priority-broadcasts/commands/{id}Komutun oynatıcı bildirimleri · priority:write
Yazma uçları sunucuda etkinleştirildiğinde kullanılabilir ve Idempotency-Key gerektirir. Medya/playlist/yayın izinleri ayrı ayrı seçilir. Yayın yanıtı cihazın oynatmaya başladığını değil, manifestin kaydedildiğini bildirir.
Online bilgisi son cihaz bildirimine dayanır; videonun o anda oynadığını doğrulamaz. Gruplanmamış ekranlarda groupId değeri null döner.
Öncelikli Yayın: Görseli ve hedefleri panelde tanımlayın, ekranın Hazır olmasını bekleyin. Tetikleme 202 kabul yanıtıdır; gösterim sonucunu komut kimliğiyle izleyin. Geçerli lisans ve priority:write gerekir. Aynı olayın tekrarında aynı Idempotency-Key kullanılır (24 saat). Bağlantısız ekrana uyarı kuyruğa alınmaz; normal playlist arka planda devam eder.
ENTEGRASYON NOTLARI
Öngörülebilir kullanım
Anahtar başına istek sınırı. Hesap genelinde 300 istek/dakika.
Bir sayfanın üst sınırı. Varsayılan sayfa boyutu 50.
Sınıra ulaşırsanız başlıkta belirtilen saniye kadar bekleyin.
Geçersiz anahtar veya eksik izin. Anahtar durumunu ve seçilen izinleri kontrol edin.