Saltar al contenido principal

Acerca de los enlaces de descarga de archivos de video con la API

Esta función requiere un plan Standard, Advanced, Pro, Business, Premium o Enterprise.

Puede obtener enlaces directos a los archivos de video desde su cuenta mediante la API. El objeto de respuesta en video puede contener varios campos para acceder a estos archivos, incluidos reproducir, archivosy descargar. En este artículo se explica qué son esos campos y cómo deben utilizarse.

En este artículo:

Qué debe saber antes de comenzar

  • Para obtener enlaces directos a archivos de video, debe enviar una solicitud al punto final del video utilizando un token de autenticación que tenga los ámbitos público, privado y archivos_de_video.
  • Los enlaces devueltos en todos estos campos son redireccionamientos HTTP 302 a la ubicación real del archivo de video en una de nuestras CDN. 
    • La ubicación de estos archivos en nuestras CDN tiene un tiempo de vida y vence cada pocas horas, por lo que siempre debe usar los enlaces de redireccionamiento exactamente como se proporcionan.
  • Los archivos HLS de los videos subidos (excepto los videos en vivo) se pueden descargar una vez que el material se haya optimizado y transcodificado.

Descripción de los campos 'reproducir', 'archivos' y 'descargar'

Cuando solicita los metadatos de un video, la respuesta puede contener tres campos distintos para acceder a los archivos de video. Cada uno tiene un propósito diferente.

  • Reproducir: estos enlaces están optimizados para la reproducción y vencen después de 24 horas, lo que proporciona una capa adicional de seguridad.
    • Recomendamos utilizar el campo de juego para reproductores externos. 
  • Archivos: el campo de archivos contiene enlaces y metadatos relacionados, como las dimensiones del video y el tamaño del archivo. Estos enlaces no caducan.
    • Dado que no vencen,no se recomienda el uso de estos enlaces con reproductores de terceros.
  • Descargar: el campo de descarga contiene enlaces que expiran (válidos por 24 horas) a los archivos de video, junto con la fecha de vencimiento de cada enlace y los metadatos relacionados. Estos enlaces incluyen encabezados que le dicen al navegador web que descargue el archivo en lugar de reproducirlo en el navegador.

Próximos pasos sugeridos:

Obtenga más información de la Guía para desarrolladores en API de Vimeo: obtener un video específico, API de Vimeo: respuesta de reproducción y API de Vimeo: respuesta en video.

Artículos relacionados