Enlaces compartibles API

Esta API permite generar enlaces seguros y públicos para tus activos de medios. Estos enlaces pueden estar protegidos por contraseña y tener una fecha de expiración.

Generar un enlace compartible

POST /enlaces-compartibles

Esta API crea un enlace único para un Video (VOD), un Transmisión en vivo o una Colección de videos.

Cuerpo de la solicitud

Campo	Tipo	Requerido	Descripción
`media_id`	`string`	Sí	El ID único del activo. Este es un UUID para los videos.
`media_type`	`string`	Sí	El tipo de activo. Debe ser uno de: `vod`, `live`, `collection`.
`visibility`	`string`	Sí	El nivel de acceso. Debe ser uno de: `public`, `password`.
`password`	`string`	Opcional	Requerido si `visibility` es `password`. Mínimo 6 caracteres.
`expires_in_days`	`integer`	Opcional	El número de días hasta que el enlace se vuelve a generar automáticamente. Máximo 365.

Ejemplos de solicitudes

Para un Video (VOD)


{
    "media_id": "9c1a9e3e-6c9b-4f8a-8e2d-9b3c1d4e0f6a",
    "media_type": "vod",
    "visibility": "public",
    "expires_in_days": 7
}

Para una Colección


{
    "media_id": "42",
    "media_type": "collection",
    "visibility": "public"
}

Protegido por contraseña


{
    "media_id": "9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f",
    "media_type": "live",
    "visibility": "password",
    "password": "super-secret-password"
}

Ejemplo de respuesta: 201 Creado

Al tener éxito, la API devolverá los detalles del enlace generado.


{
  "link": "https://tu-aplicación.com/s/aBcDeFgHiJkLmNoPqRsTuVwXyZaBcDeFgHiJkLmNoP",
  "token": "aBcDeFgHiJkLmNoPqRsTuVwXyZaBcDeFgHiJkLmNoP",
  "visibility": "public",
  "expires_at": "2025-08-17T14:30:00Z"
}