ads

API REST per la tua piattaforma di streaming

Gestisci catalogo, artwork, canali in diretta, merchandising e report con un'API REST che rispecchia l'area di amministrazione.

La chiamata « Add New Video » nella documentazione API della piattaforma su un laptop, con lo stesso titolo aperto in un'app per smartphone

Artwork e canali in diretta tramite API

Con l'API di Vodlix, l'artwork viene associato tramite URL invece di essere caricato a mano. Una chiamata imposta le immagini verticale, orizzontale e logo di un titolo, un'altra sceglie quale fotogramma generato fa da miniatura. I canali in diretta sono gestiti come i video: creati da un URL di stream, aggiornati, pubblicati o ritirati, spostati nel cestino o ripristinati, così i contenuti lineari si automatizzano come quelli on demand. Per un catalogo grande o che cambia spesso, l'artwork resta coerente senza che nessuno debba caricare i file uno alla volta.


Documentazione API di « Update Content Thumbs », che imposta l'artwork verticale, orizzontale e logo di un titolo a partire da URL di immagini
Rest icon
API REST

Familiare e prevedibile.

Mirror icon
Rispecchia l'admin

Se conosci l'interfaccia, conosci l'API.

Full icon
Ciclo di vita completo

Crea, pubblica, ritira, ripristina.

Gestisci il catalogo in modo programmatico

L'API REST di Vodlix ti permette di gestire il catalogo in modo programmatico, rispecchiando l'area di amministrazione. I video possono essere creati, aggiornati, pubblicati o ritirati, spostati nel cestino o ripristinati. Serie e stagioni si creano, aggiornano e pubblicano allo stesso modo, e gli episodi vengono associati a una stagione o scollegati da essa. I nuovi video vengono acquisiti fornendo alla piattaforma l'URL di un file, pubblico o nel tuo storage S3 o Wasabi: la piattaforma recupera ed elabora il file in background e restituisce un ID video con cui seguirne l'avanzamento. Per gli operatori OTT con sistemi già esistenti, la gestione del catalogo può essere automatizzata invece che svolta a mano.


Documentazione API di « Upload with URL », che acquisisce un video dall'URL di un file su storage pubblico, S3 o Wasabi
Home page dello storefront con le righe « Top 10 » e « Rent the Latest », liste di contenuti che una chiamata API può attivare e disattivare

Merchandising e liste di contenuti sotto il controllo dell'API

L'API di Vodlix ti dà il controllo del merchandising: liste di contenuti, gruppi di liste, i loro elementi e il loro ordine possono essere creati e gestiti in modo programmatico. Le liste si possono attivare e disattivare, così una riga stagionale si spegne con una chiamata API invece di essere ricostruita. In questo modo i sistemi di palinsesto e gli strumenti di pianificazione dei contenuti possono comporre la home page automaticamente. È il merchandising controllato via API a permettere ai flussi editoriali di crescere.


Endpoint di riferimento e reportistica

L'API di Vodlix offre chiamate di riferimento e reportistica: ID delle categorie, conteggio di catalogo e utenti, un riepilogo delle vendite per qualsiasi intervallo di date e dettagli della piattaforma come la versione del software. Le integrazioni sanno sempre con cosa stanno lavorando e possono adattarsi ai cambiamenti della piattaforma. L'accesso avviene tramite chiavi API create nell'admin: una chiave server per i processi back-end e una chiave client per il codice nel browser, che non può mai raggiungere le route di amministrazione. Le stesse chiamate sono disponibili per gli assistenti IA tramite il connettore MCP della piattaforma.


Tabella degli strumenti MCP Access con informazioni sulla piattaforma, conteggio di contenuti e utenti, navigazione del catalogo e riepilogo delle vendite

Dove di solito ripaga l'investimento

I casi più comuni sono migrazione, ingest e reportistica. Trasferire un catalogo da un'altra piattaforma diventa un lavoro dell'API invece che manuale, ed è la differenza tra un lancio che non aspetta nessuno e uno che si misura in mesi. L'ingest ricorrente da un distributore o da un flusso di produzione gira senza supervisione una volta scritto. La reportistica porta i dati negli strumenti che il tuo team finanziario usa già, invece di chiedere a qualcuno di esportare una schermata ogni lunedì.


Collega inoltre la tua piattaforma al resto della tua attività. Invia un nuovo titolo al tuo CMS e al tuo sito di marketing nel momento in cui viene pubblicato, oppure passa le tue liste di contenuti a un servizio di raccomandazione e riscrivi i risultati. Quando un'integrazione richiede più di quanto offra la sola API, il nostro servizio di plugin personalizzati sviluppa il pezzo mancante sulla stessa piattaforma.


Le analytics sono disponibili tramite API quando sul tuo cloud è configurato un servizio di statistiche: conviene verificarlo in fase di configurazione invece di scoprirlo più tardi. La pagina report e analytics spiega cosa viene misurato.


Domande Frequenti

Hai domande su come sfruttare questa offerta a tempo limitato? Controlla le FAQ per le risposte

Cosa può controllare l'API REST di Vodlix?
L'API REST di Vodlix controlla il catalogo, inclusi video, serie, stagioni ed episodi, oltre ad artwork, canali in diretta, liste di contenuti e merchandising, e dati di riferimento e reportistica.
Carico i file video tramite l'API di Vodlix?
I nuovi video vengono acquisiti tramite l'API di Vodlix fornendo un URL HTTPS pubblico. Vodlix recupera e transcodifica il file, così non devi far passare upload binari attraverso la tua infrastruttura.
L'API di Vodlix rispecchia l'area di amministrazione?
Sì. L'API REST di Vodlix rispecchia l'area di amministrazione, con convenzioni REST familiari e risposte prevedibili: chi conosce l'interfaccia sa più o meno cosa può fare l'API.
Posso gestire le liste di contenuti tramite l'API di Vodlix?
Sì. Le liste di contenuti Vodlix, i gruppi di liste, i loro elementi e il loro ordine possono essere creati, aggiornati, attivati e disattivati tramite API, così il merchandising può essere automatizzato.
Quali dati di reportistica fornisce l'API di Vodlix?
L'API di Vodlix fornisce il conteggio di catalogo e utenti, un riepilogo delle vendite per un intervallo di date, gli ID delle categorie e i dettagli della piattaforma come la versione del software, così le integrazioni sanno sempre con cosa stanno lavorando.
Gli ID delle categorie sono uguali su ogni cloud Vodlix?
No, ed è l'errore più comune. Le categorie sono specifiche di ogni cloud: leggi l'elenco delle categorie della piattaforma su cui stai lavorando e usa gli ID che restituisce, invece di dare per scontato che un nome corrisponda ovunque allo stesso numero.
Possiamo ottenere le analytics tramite API?
Sì, quando sul tuo cloud è configurato un servizio di statistiche, con i dati principali, l'attività in tempo reale e i contenuti più performanti. Conviene verificarlo in fase di configurazione, perché viene attivato separatamente dalle operazioni sul catalogo.
L'API è utile per migrare da un'altra piattaforma?
È uno dei motivi più comuni per cui gli operatori la usano. Trasferire un catalogo in modo programmatico trasforma una migrazione in un'attività ripetibile invece che in mesi di inserimento manuale, e può essere rieseguita per recuperare tutto ciò che è cambiato durante il trasferimento.
Come si autenticano le integrazioni con l'API di Vodlix?
Con una chiave API creata nell'admin in « Apps & APIs » e inviata nell'header X-Api-Key. Una chiave server agisce con i permessi dell'utente a cui appartiene e può raggiungere le route di amministrazione, quindi va usata su un back-end. Una chiave client è sicura per il codice nel browser ed è bloccata su tutte le route di amministrazione. Le chiavi possono avere una data di scadenza, ed eliminare una chiave la revoca immediatamente.