Playlistler API
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.