Skip to Content
DocumentationAPI ReferenceTransmisión en vivo

Transmisión en vivo API

La transmisión en vivo API proporciona puntos de conexión para descubrir y recuperar información sobre tus eventos en vivo. Esto te permite crear directorios “En vivo ahora” y insertar jugadores en vivo en tus aplicaciones.

Obtener Transmisiones Actuales

Este es el punto de conexión principal para descubrir transmisiones que están actualmente “en vivo”. Devuelve una lista con solo las transmisiones que están recibiendo señal activa desde un codificador.

GET /transmisiones-en-vivo/activas

Parámetros

Este punto de conexión no requiere parámetros. Devolverá todas las transmisiones actuales para tu cuenta.

Solicitud de ejemplo

GET /api/cliente/v1/transmisiones-en-vivo/activas
Host: https://tu-aplicación.com
Autorización: Bearer sk-tu-api-clave-aquí

Respuesta: GET /transmisiones-en-vivo/activas

Si las transmisiones están activas, recibirás un array de objetos Transmisión en vivo. El estado será activo y se incluirá un objeto manifiesto.

Respuesta: 200 OK (Transmisiones Activas)
{
  "data": [
    {
      "id": "9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f",
      "titulo": "Sesión de preguntas y respuestas semanal",
      "descripcion": "Respondiendo a tus preguntas en vivo.",
      "estado": "activo",
      "manifiesto": {
        "hls_url": "https://tu-aplicación.com/almacenamiento/transmisiones-en-vivo/viva/9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f/adaptativo/master.m3u8"
      },
      "metadata": {
        "categoria": "Charla técnica",
        "anfitrión": "Jane Doe"
      },
      "etiquetas": ["transmisión en vivo", "preguntas y respuestas"],
      "creado_en": "2024-08-01T10:00:00Z"
    }
  ]
}

Si no hay transmisiones activas actualmente, el API devolverá un array vacío de datos.

Respuesta: 200 OK (No Transmisiones Activas)
{
  "data": []
}

Obtener Todas las Transmisiones en Vivo

Este punto de conexión proporciona una lista paginada de todas las transmisiones en vivo configuradas en tu cuenta, independientemente de su estado actual (activo o inactivo). Esto es útil para crear un calendario o una lista completa de canales disponibles.

GET /transmisiones-en-vivo

Parámetros

NombreTipoRequeridoDescripción
por_páginaenteroOpcionalEl número de transmisiones a devolver por página. Por defecto: 15, Máximo: 100.

Solicitud de ejemplo

GET /api/cliente/v1/transmisiones-en-vivo?por_página=2

Respuesta: GET /transmisiones-en-vivo

La respuesta es una lista estándar paginada. El estado será activo o inactivo, y el objeto manifiesto solo estará presente para transmisiones activas.

Respuesta: 200 OK
{
  "data": [
    {
      "id": "9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f",
      "titulo": "Sesión de preguntas y respuestas semanal",
      "descripcion": "Respondiendo a tus preguntas en vivo.",
      "estado": "activo",
      "manifiesto": {
        "hls_url": "https://tu-aplicación.com/almacenamiento/transmisiones-en-vivo/viva/9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f/adaptativo/master.m3u8"
      },
      "metadata": {
        "categoria": "Charla técnica"
      },
      "etiquetas": ["transmisión en vivo", "preguntas y respuestas"],
      "creado_en": "2024-08-01T10:00:00Z"
    },
    {
      "id": "9c1a9e3e-1a2b-3c4d-5e6f-7g8h9i0j1k2l",
      "titulo": "Lanzamiento de producto próximo",
      "descripcion": "Únete a nosotros para la gran revelación.",
      "estado": "inactivo",
      "metadata": {
        "categoria": "Producto"
      },
      "etiquetas": ["lanzamiento", "evento"],
      "creado_en": "2024-07-25T15:00:00Z"
    }
  ],
  "enlaces": {
    "primero": "https://tu-aplicación.com/api/cliente/v1/transmisiones-en-vivo?page=1",
    "último": "https://tu-aplicación.com/api/cliente/v1/transmisiones-en-vivo?page=3",
    "anterior": null,
    "siguiente": "https://tu-aplicación.com/api/cliente/v1/transmisiones-en-vivo?page=2"
  },
  "meta": {
    "página actual": 1,
    "desde": 1,
    "última página": 3,
    "ruta": "https://tu-aplicación.com/api/cliente/v1/transmisiones-en-vivo",
    "por_página": 2,
    "hasta": 2,
    "total": 6
  }
}

Obtener una Transmisión en Vivo Individual

Recupera los detalles completos de una transmisión en vivo específica por su ID. Este es el punto de conexión que llamarías para obtener la información necesaria para cargar una transmisión en un jugador.

GET /transmisiones-en-vivo/{idDeLaTransmisión}

Parámetros de ruta

NombreTipoDescripción
idDeLaTransmisiónuuidRequerido. El identificador único de la transmisión en vivo.

Solicitud de ejemplo

GET /api/cliente/v1/transmisiones-en-vivo/9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f

Respuesta: GET /transmisiones-en-vivo/{idDeLaTransmisión}

La respuesta es un objeto Transmisión en vivo individual. El manifiesto estará presente si la transmisión está activa.

Respuesta: 200 OK (Transmisión Activa)
{
  "data": {
    "id": "9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f",
    "titulo": "Sesión de preguntas y respuestas semanal",
    "descripcion": "Respondiendo a tus preguntas en vivo.",
    "estado": "activo",
    "manifiesto": {
      "hls_url": "https://tu-aplicación.com/almacenamiento/transmisiones-en-vivo/viva/9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f/adaptativo/master.m3u8"
    },
    "metadata": {
      "categoria": "Charla técnica",
      "anfitrión": "Jane Doe"
    },
    "etiquetas": ["transmisión en vivo", "preguntas y respuestas"],
    "creado_en": "2024-08-01T10:00:00Z"
  }
}
VídeosSubir videos