Playlistler API (Çok Yakında)
Çok yakında — herkese açık GoVista API'si henüz kullanıma sunulmadı. Aşağıdaki uç noktalar ön izlemedir ve lansmandan önce değişebilir. Erken erişim için hesap yöneticinizle iletişime geçin.
Playlistler API
Playlistleri programatik olarak oluşturun, yönetin ve dağıtın.
Playlistleri Listele
`` GET /v1/playlists ``
Sorgu parametreleri:
page,limit— Sayfalamasearch— Ada göre arama
Yanıt: ``json { "success": true, "data": [ { "id": "pl_abc123", "name": "Sabah Menüsü", "mode": "sequential", "item_count": 5, "total_duration": 50, "created_at": "2025-01-15T10:30:00Z", "updated_at": "2025-01-16T14:00:00Z" } ] } ``
Playlist Oluşturma
`` POST /v1/playlists ``
İstek gövdesi: ``json { "name": "Happy Hour Özel", "mode": "sequential", "items": [ { "content_id": "asset_abc", "duration": 10 }, { "content_id": "asset_def", "duration": 15 } ] } ``
Modlar: sequential, shuffle, weighted
Ağırlıklı mod için her öğeye weight ekleyin: ``json { "content_id": "asset_abc", "duration": 10, "weight": 60 } ``
Playlist Detayı
`` GET /v1/playlists/:id ``
Playlist Güncelleme
`` PATCH /v1/playlists/:id ``
Playliste Öğe Ekleme
`` POST /v1/playlists/:id/items ``
Playlistten Öğe Kaldırma
`` DELETE /v1/playlists/:id/items/:item_id ``
Playlist Dağıtma
`` POST /v1/playlists/:id/deploy ``
İstek gövdesi: ``json { "targets": [ { "type": "store", "id": "store_abc" }, { "type": "device", "id": "dev_xyz" }, { "type": "tag", "value": "menu-panosu" } ] } ``
İçerik dağıtımını otomatikleştirmek için deploy uç noktasını kullanın. Örneğin, POS sisteminiz menüyü güncellediğinde otomatik olarak playlist dağıtımı tetikleyin.
Playlist Silme
`` DELETE /v1/playlists/:id ``
API üzerinden playlist dağıtmak yeni bir manifest oluşturur ve cihazlara gönderir. Boş ekranları önlemek için dağıtımdan önce playlistin geçerli içerik öğeleri içerdiğinden emin olun.