Skip to Content
DocumentationAPI ReferenceIn onda in diretta

Flussi in diretta API

I flussi in diretta API forniscono endpoint per la scoperta e il recupero di informazioni sui tuoi eventi in diretta. Ciò consente di costruire “directory in diretta” e di inserire giocatori in diretta nei tuoi applicativi.

Ottieni i flussi attivi

Questo è l’endpoint principale per la scoperta dei flussi che sono attualmente “in onda”. Restituisce una lista dei soli flussi che stanno ricevendo un segnale da un encoder.

GET /live-streams/active

Parametri

Questo endpoint non accetta alcun parametro. Restituirà tutti i flussi attivi per il tuo account.

Esempio di richiesta

GET /api/client/v1/live-streams/active
Host: https://your-app.com
Authorization: Bearer sk-your-api-key-here

Risposta: GET /live-streams/active

Se i flussi sono attivi, riceverai un array di oggetti LiveStream. Lo stato sarà active e un oggetto manifest sarà presente.

Risposta: 200 OK (Flussi Attivi)
{
  "data": [
    {
      "id": "9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f",
      "title": "Sessione di domande settimanale",
      "description": "Rispondi alle tue domande in diretta.",
      "status": "active",
      "manifest": {
        "hls_url": "https://your-app.com/storage/live_media/live/9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f/adaptive/master.m3u8"
      },
      "metadata": {
        "categoria": "Discorsi tecnici",
        "ospite": "Jane Doe"
      },
      "tags": ["in diretta", "q&a"],
      "created_at": "2024-08-01T10:00:00Z"
    }
  ]
}

Se non ci sono flussi attualmente in onda, il API restituirà un array vuoto.

Risposta: 200 OK (Nessun Flusso Attivo)
{
  "data": []
}

Ottieni tutti i flussi in diretta

Questo endpoint fornisce una directory paginata di tutti i flussi in diretta configurati nel tuo account, indipendentemente dal loro stato attuale (attivo o disattivo). Ciò è utile per costruire un calendario o una lista completa dei canali disponibili.

GET /live-streams

Parametri

NomeTipoRichiestoDescrizione
per_pageintegerOpzionaleIl numero di flussi da restituire per pagina. Predefinito: 15, Massimo: 100.

Esempio di richiesta

GET /api/client/v1/live-streams?per_page=2

Risposta: GET /live-streams

La risposta è una lista standardizzata paginata. Lo stato sarà active o inactive, e l’oggetto manifest sarà presente solo per i flussi attivi.

Risposta: 200 OK
{
  "data": [
    {
      "id": "9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f",
      "title": "Sessione di domande settimanale",
      "description": "Rispondi alle tue domande in diretta.",
      "status": "active",
      "manifest": {
        "hls_url": "https://your-app.com/storage/live_media/live/9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f/adaptive/master.m3u8"
      },
      "metadata": {
        "categoria": "Discorsi tecnici"
      },
      "tags": ["in diretta", "q&a"],
      "created_at": "2024-08-01T10:00:00Z"
    },
    {
      "id": "9c1a9e3e-1a2b-3c4d-5e6f-7g8h9i0j1k2l",
      "title": "Lancio del prodotto imminente",
      "description": "Unisciti alla grande rivelazione.",
      "status": "inactive",
      "metadata": {
        "categoria": "Prodotti"
      },
      "tags": ["lancio", "evento"],
      "created_at": "2024-07-25T15:00:00Z"
    }
  ],
  "links": {
    "first": "https://your-app.com/api/client/v1/live-streams?page=1",
    "last": "https://your-app.com/api/client/v1/live-streams?page=3",
    "prev": null,
    "next": "https://your-app.com/api/client/v1/live-streams?page=2"
  },
  "meta": {
    "pagina corrente": 1,
    "da": 1,
    "ultima pagina": 3,
    "percorso": "https://your-app.com/api/client/v1/live-streams",
    "per_page": 2,
    "a": 2,
    "totale": 6
  }
}

Ottieni un singolo flusso in diretta

Recupera i dettagli completi per un flusso in diretta specifico tramite il suo ID. Questo è l’endpoint che chiameresti per ottenere le informazioni necessarie per caricare un flusso in un giocatore.

GET /live-streams/{streamId}

Parametri di percorso

NomeTipoDescrizione
streamIduuidRichiesto. L’identificatore univoco del flusso in diretta.

Esempio di richiesta

GET /api/client/v1/live-streams/9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f

Risposta: GET /live-streams/{streamId}

La risposta è un oggetto LiveStream singolo. Il manifesto sarà incluso se il flusso è attivo.

Risposta: 200 OK (Flusso Attivo)
{
  "data": {
    "id": "9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f",
    "title": "Sessione di domande settimanale",
    "description": "Rispondi alle tue domande in diretta.",
    "status": "active",
    "manifest": {
      "hls_url": "https://your-app.com/storage/live_media/live/9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f/adaptive/master.m3u8"
    },
    "metadata": {
      "categoria": "Discorsi tecnici",
      "ospite": "Jane Doe"
    },
    "tags": ["in diretta", "q&a"],
    "created_at": "2024-08-01T10:00:00Z"
  }
}
VideoCaricamenti di video