Nuova API di streaming live RESTful per emittenti e sviluppatori

Noi di Dacast siamo orgogliosi di annunciare ufficialmente che è disponibile la versione 2 della nostra API per lo streaming in diretta. Questa API RESTful JSON è stata progettata specificamente per l’integrazione rapida e semplice di tutte le funzionalità della piattaforma di servizi di streaming Dacast in un’ampia gamma di applicazioni video cloud, servizi e flussi di lavoro multimediali digitali.

In questo blog vogliamo introdurvi al concetto di API, spiegarvi cosa siete in grado di costruire utilizzando la nostra API di Live Streaming e illustrarvi alcuni dei comandi di base che potete utilizzare per manipolare i vostri dati con questo strumento. Alla fine di questo post forniremo anche un link alla nostra documentazione e ad altre risorse per l’apprendimento.

Che cos’è un’API?

API è l’acronimo di Application Programming Interface. Un’interfaccia di programmazione delle applicazioni è un mezzo semplificato per inviare e recuperare dati da un sistema informatico complesso,in questo caso la rete di hosting video e la piattaforma di gestione Dacast.

Un’API funziona attraverso un sistema di operazioni, input, output e tipi di dati sottostanti che sono standardizzati in tutta la piattaforma. In questo modo si crea un “linguaggio” comune (la nostra API utilizza il formato JSON) che utilizza comandi e URL prevedibili che i programmatori possono utilizzare per creare i propri metodi di interazione con i dati memorizzati su un’altra rete all’interno di una piattaforma proprietaria.

I dati all’interno della piattaforma cambieranno e Dacast potrà continuare ad aggiungere nuove funzionalità e a iterare le nostre tecnologie, ma il linguaggio API rimarrà lo stesso, con l’aggiunta di una o due nuove chiamate per consentire agli utenti di sfruttare nuove capacità senza interrompere le applicazioni e i servizi costruiti sull’API esistente.

In pratica, un’API consente agli utenti di Dacast di personalizzare quasi ogni aspetto dell’esperienza di visualizzazione e di impostare manualmente i propri metodi per caricare, rinominare, spostare, etichettare, accedere e gestire in altro modo i contenuti sulla piattaforma Dacast.

La nuova API per lo streaming live di Dacast: Versione 2

La versione 2 dell’API Dacast Live Streaming amplia le funzionalità fornite dalla versione 1, in modo che i nostri power user e i clienti aziendali siano ora in grado di utilizzare tutte le funzionalità di Dacast senza dover accedere ai loro account Dacast. Questo rilascio offre ai nostri utenti un potere ancora maggiore sui loro contenuti e, a nostro avviso, è un motivo convincente per prendere in considerazione l’utilizzo della nostra API di Live Streaming.

Le aziende e le organizzazioni che cercano il controllo totale e la personalizzazione possono arrivare a costruire la propria piattaforma di streaming video basata sul backend Dacast. Su scala ridotta, chiunque può utilizzare la nostra API di Live Streaming per accedere facilmente ai dati, estrarre informazioni dal proprio account, caricare e modificare informazioni tramite un dispositivo remoto, codificare un’app e così via.

Caratteristiche dell’API per lo streaming live di Dacast

Le funzioni incluse nell’API Dacast Live Streaming sono troppo numerose per essere elencate per intero, ma ecco alcuni dei punti salienti.

Scrivere file e canali

La nostra API di Live Streaming vi permette di pubblicare video sul vostro canale di streaming direttamente all’interno delle vostre applicazioni o piattaforme. Ciò consente di creare un flusso di lavoro semplificato che può coesistere con le attuali piattaforme software. È inoltre possibile creare e caricare video per la visualizzazione on-demand all’interno dell’API di Live Streaming, senza dover utilizzare il sito web di Dacast.

Leggere file e canali

Allo stesso modo, l’API di Live Streaming consente di controllare la visualizzazione dei contenuti. Ciò consente di programmare interfacce personalizzate per visualizzare i video su dispositivi unici e in situazioni altrimenti inaccessibili. È possibile, ad esempio, codificare una propria applicazione mobile da distribuire agli utenti come hub centrale per la visualizzazione dei contenuti on-demand e live streaming all’interno di un ambiente controllato dal marchio.

È inoltre possibile utilizzare i comandi di lettura per scaricare facilmente informazioni dal proprio account, come ad esempio creare un elenco di tutti i video ordinati in base alla loro durata o alla data di caricamento.

Creare nuovi account (e amministratori)

Con la nostra API di Live Streaming, anche le attività di gestione più banali, come la distribuzione e il controllo dell’accesso al vostro account, non richiedono l’utilizzo diretto della piattaforma Dacast. Invece, è possibile farlo tramite applicazioni personalizzate o terminali a riga di comando per semplificare i flussi di lavoro. Ciò include anche la gestione del controllo dell’accesso agli account e la fornitura delle credenziali ai nuovi utenti.

Funzionalità del rivenditore

I rivenditori a valore aggiunto (VAR) di Dacast acquistano piani di accesso alla nostra piattaforma di hosting video e poi la rivendono in piccole porzioni ad altri clienti. Grazie alla nostra API di Live Streaming, i VAR possono ora creare la propria piattaforma di streaming video in diretta per i loro clienti. Questa piattaforma può essere personalizzata a piacere, senza dover utilizzare la piattaforma, il nome o il logo di Dacast, e sarà dotata di tutte le funzionalità di Dacast disponibili per i nostri utenti.

Accesso alla monetizzazione in lettura e scrittura

È inoltre possibile utilizzare la nostra API di Live Streaming per controllare le impostazioni di monetizzazione. Ad esempio, è possibile configurare la monetizzazione per i nuovi video al volo, man mano che le trasmissioni vanno in onda e i video vengono caricati. È inoltre possibile accedere ai dati di monetizzazione e modificare le impostazioni dei video esistenti dall’API di Live Streaming.

Accesso ai dati analitici

Dacast mantiene una serie di analisi dettagliate per tracciare le informazioni e le prestazioni su chi visualizza i vostri contenuti, per quanto tempo, da quali luoghi e così via.

L’API consente di accedere ai dati analitici in forma grezza, in modo da poter codificare le proprie visualizzazioni personalizzate, selezionare le metriche più rilevanti e raccogliere le informazioni più importanti per le proprie attività. Questi dati possono essere essenziali per prendere decisioni informate sul marketing e per modificare l’approccio ai contenuti futuri.

Pubblicare su un portale

La nostra API per il Live Streaming vi permette di creare facilmente i vostri portali video o audio per un accesso personalizzato ai vostri contenuti, senza bisogno di utilizzare un lettore video o un’infrastruttura Dacast. Invece, è sufficiente inserire i contenuti nel portale personalizzato in base alle esigenze.

Accesso alla transcodifica dei file

Uno degli elementi più potenti del sistema Dacast è la capacità di transcodificare i file nel cloud nei formati necessari per raggiungere il pubblico. La nuova API per il Live Streaming fornisce un accesso diretto alla potente architettura del server alla base di questo processo, consentendo di implementare impostazioni di contenuto personalizzate e di fornire agli spettatori i file multimediali di loro scelta.

Controlli per playlist e pacchetti

La piattaforma di Dacast include la possibilità di creare playlist di contenuti che possono essere incorporati e riprodotti in sequenza. I pacchetti, solitamente utilizzati per creare una raccolta di contenuti che possono essere monetizzati con un unico abbonamento o con una tariffa pay-per-view, sono un’altra opzione per raggruppare i contenuti.

Entrambe le opzioni di raggruppamento possono essere create, modificate e controllate tramite la nuova versione 2 dell’API Live Streaming.

Miglioramenti delle prestazioni

I miglioramenti apportati all’API di Live Streaming hanno anche incrementato le prestazioni della piattaforma in generale. Ora le richieste di dati e le operazioni saranno eseguite in modo più efficiente e veloce, garantendo un’esperienza utente più rapida e una maggiore produttività.

Riproduttori video personalizzati

La nuova API di Live Streaming consente anche l’accesso completo all’API del lettore video di Dacast, in modo da poter personalizzare il nostro lettore video white label o addirittura creare la propria soluzione in base alle esigenze di branding, stile o funzionalità della vostra organizzazione. I lettori personalizzati possono supportare video HTML5 o Flash, supportare sistemi DRM avanzati e ottimizzare il SEO con metadati e tag.

I player video personalizzati consentono inoltre l’integrazione con piattaforme di terze parti per l’acquisizione di e-mail, richieste di azioni, pubblicità e altre forme di monetizzazione e piattaforme di analisi come Google Analytics, ComScore e altre.

Architettura dell’API per lo streaming live di Dacast

Le moderne API dedicate alla modifica e al controllo dei contenuti che si trovano su un’altra rete utilizzano spesso uno standard REST (Representational State Transfer) per garantire che i dati vengano comunicati in modo robusto tra client e piattaforma.

La nuova API di Dacast Live Streaming è di tipo REST, il che significa che è possibile accedervi da qualsiasi applicazione server o client di vostra scelta. Ciò significa anche che è possibile utilizzare qualsiasi linguaggio di programmazione di propria scelta per interagire con l’API. Tutto ciò che è importante è la capacità di effettuare richieste HTTP GET e POST e di gestire le risposte nel formato JSON.

Nozioni di base dell’API

I comandi dell’API Dacast Live Streaming sono suddivisi in nove categorie che coprono tutte le funzioni di Dacast. Queste categorie sono:

1. Video su richiesta
2. Canale live
3. Playlist
4. Pacchetto
5. Preferenze
6. Analisi
7. Informazioni sul conto
8. Informazioni al pubblico
9. Elenco degli errori

Ciascuna di queste categorie contiene un elenco completo di comandi per manipolare e interagire con la piattaforma Dacast. All’interno di ogni categoria, le sottocategorie aiutano a delineare i comandi che influiscono su quale parte dell’operazione. Per ogni comando, i parametri consentono di personalizzare le richieste.

Comandi del canale live

Ad esempio, la categoria “Canale live” comprende quattro sottocategorie. Questi sono:

• 2.1 – Operazioni di base
• 2.2 – Operazioni sui tassi
• 2.3 – Operazioni di cedola
• 2.4 – Operazioni di analisi (che contiene operazioni deprezzate che non sono più utilizzate nella versione 2 della nostra API di Live Streaming)

Ciascuna di queste categorie comprende un elenco di operazioni progettate per modificare e interagire con i dati. Ad esempio, ecco un elenco dei comandi presenti nella sezione 2.1 – Operazioni di base.

• GET /v2/channel (Elenco dei canali del proprio account)
• POST /v2/channel (creare un nuovo canale)
• DELETE /v2/channel/{channel_id} (Cancellare un canale)
• GET /v2/channel/{channel_id} (Ottenere i dettagli del canale)
• PUT /v2/channel/{channel_id} (Aggiorna i dettagli del canale)
• GET /v2/channel/{channel_id}/embed/{embed_type} (Ottenere il codice di incorporamento del canale)
• DELETE /v2/channel/{channel_id}/splash (Elimina la schermata personalizzata)
• POST /v2/channel/{channel_id}/splash (caricare lo schermo personalizzato)
• GET /v2/channel/{channel_id}/startstream (ottenere i dettagli del canale)
• DELETE /v2/channel/{channel_id}/thumbnail (Eliminare la miniatura personalizzata)
• POST /v2/channel/{channel_id}/thumbnail (caricare una miniatura personalizzata)
• POST /v2/channel/{channel_id}/xml (ottenere l’XML del canale)

Parametri del comando

La maggior parte di questi comandi ha anche una serie di parametri diversi che possono essere utilizzati per restituire i dati in un ordine diverso o per personalizzare le informazioni in altri modi.

Comando GET Channel

Ad esempio, il primo comando restituisce un elenco di tutti i canali live dell’account. L’invio di questo operatore a Dacast comporta semplicemente l’inserimento di un URL nel browser (o in un terminale o in un’applicazione connessa al web). L’URL completo per questo comando di base sarebbe: http://api.dacast.com/v2/channel?apikey={your_apikey}.

Questo comando può essere personalizzato utilizzando tre parametri. Il primo, “ordinamento”, consente di scegliere un ordine crescente o decrescente per disporre i risultati. Il secondo parametro, “order by”, sceglie la metrica con cui ordinare i risultati. Ad esempio, si può ordinare per titolo dalla A alla Z con i seguenti parametri: http://api.dacast.com/v2/channel?apikey={your_apikey}&order_by=title&sort=DSC.

Il terzo parametro è il filtro, che (come dice il nome) consente di filtrare in base ad attributi più specifici. Ad esempio, è possibile filtrare l’elenco in modo che contenga solo i flussi che hanno un determinato nome, data di creazione, impostazione pay-per-view, durata e così via. Questo parametro viene aggiunto utilizzando una serie di tag elencati in modo completo nella documentazione collegata di seguito.

Comando PUT Dettagli canale

Come ulteriore esempio, il comando Aggiorna dettagli canale contiene una serie di parametri che consentono di modificare tutte le impostazioni relative a un determinato canale. (Nota: per modificare questi parametri, è necessario il numero ID del canale, che si può trovare utilizzando il primo comando GET Channel).

Le impostazioni che possono essere personalizzate con questo comando includono:

• Titolo del canale
• Descrizione
• Categoria
• Stato online (attivare o disattivare il canale)
• Contatore live (consente di attivare o disattivare un contatore che visualizza il numero di persone che guardano il vostro canale e di impostare la soglia per la visualizzazione di questo contatore)
• Google Analytics (abilitare o disabilitare il tracciamento di Google Analytics per questo canale)
• Autoplay (attivare o disattivare)
• Pubblicare su Dacast (attivare o disattivare la pubblicazione sul portale Dacast)
• Pagina video esterna (l’URL della pagina web su cui pubblicherete il vostro canale)
• Password (consente di proteggere con una password il proprio canale)
• Referrers ID (codice ID dell’elenco dei referenti da applicare a questo canale)
• Countries ID (codice ID dell’elenco dei paesi che si vuole far accedere al proprio canale)
• ID tema (per applicare un tema personalizzato al lettore video Dacast)
• ID Dimensione lettore (consente di impostare la dimensione della finestra del lettore video utilizzando le impostazioni predefinite comuni)
• Larghezza e altezza del lettore (consente di personalizzare le dimensioni del lettore video)
• Sicurezza NoFrame (attiva o disattiva la sicurezza dei fotogrammi)
• Splashscreen ID (consente di impostare splash screen personalizzati o di scegliere quelli predefiniti di Dacast)
• ID miniatura (consente di impostare miniature personalizzate o di scegliere quelle predefinite da Dacast)
• Dati personalizzati (un campo che può essere utilizzato per memorizzare e recuperare metadati)

Risorse API

Per saperne di più sulla nuova API Dacast Live Streaming, potete consultare la nostra documentazione completa che si trova qui. Se avete già effettuato l’accesso al vostro account Dacast, questa risorsa si trova anche nel menu Aiuto.

Per generare una chiave API, necessaria per utilizzare l’API, è possibile visitare il pannello delle preferenze della chiave API nel back office di Dacast. Una volta generata una chiave API, visitate la pagina della documentazione e inseritela nel campo in cima alla pagina.

A questo punto, la pagina di documentazione può essere utilizzata come sandbox per testare vari comandi API e imparare la piattaforma. Per testare un determinato comando utilizzando il proprio account, fare clic su una determinata operazione e poi sulla scheda “sandbox” nella parte superiore della documentazione del comando. In questa pagina è possibile testare il comando senza influenzare i dati all’interno dell’account.

Come iniziare con l’API per lo streaming in diretta di Dacast

Siamo molto entusiasti della nuova API Dacast Live Streaming e sappiamo che lo sono anche molti dei nostri clienti. Riteniamo che fornisca un nuovo potente modo di controllare i propri dati e che dovrebbe consentire ai nostri utenti di esportare la nostra tecnologia nella propria piattaforma. Se avete un piano entusiasmante per l’utilizzo dell’API di Live Streaming, contattateci: ci piacerebbe saperne di più ed eventualmente inserire la storia nel nostro blog!

Se siete già utenti di Dacast e avete problemi con la nostra API per il Live Streaming, inviate un’e-mail a support@dacast.com con la vostra chiave API, la chiamata API effettuata, le risposte o i messaggi di errore ricevuti e l’ora in cui si è verificato l’errore. Vi risponderemo al più presto!

Grazie per aver letto!