Funcionamiento de las cargas locales y remotas
Esta guía detalla el flujo completo para cargar archivos mediante la API V4 de Frame.io. Cubre las solicitudes y respuestas de API sin procesar tanto para cargas locales como remotas.
¿Busca guías específicas para SDK? Para implementaciones de carga con fragmentación, reintentos y seguimiento de progreso integrados, consulte la Guía de carga del SDK para Python.
Requisitos previos
Antes de empezar a cargar archivos, asegúrese de haber completado estos pasos de configuración:
Cuenta de Frame.io V4
Tiene una cuenta de Frame.io V4 administrada mediante Adobe Admin Console o ha cambiado a la autenticación de Adobe para el usuario de la cuenta
Configuración de Adobe Developer Console
Ha iniciado sesión en Adobe Developer Console y ha añadido la API de Frame.io a un proyecto nuevo o existente
Credenciales de autenticación
Ha generado las credenciales de autenticación adecuadas para el proyecto
Elección del método de carga
Hay dos formas de cargar un archivo mediante la API de Frame.io: Create File (local upload) y Create File (remote upload).
Úsela cuando la aplicación pueda acceder al contenido multimedia de forma local, de forma similar a arrastrar un archivo desde el escritorio
Úsela cuando se acceda al contenido multimedia a través de la red, por ejemplo, mediante una integración con otro servicio
En esta guía empezaremos con el caso más sencillo: completar una carga remota.
Carga remota
Para crear un archivo mediante carga remota, seleccione el punto final Create File (remote upload). El cuerpo de la solicitud requiere el nombre del archivo y su URL de origen.
Actualmente, la carga remota tiene un límite de tamaño de archivo de 50 GB. Para archivos de más de 50 GB, utilice la carga local.
Ejemplo de solicitud
Ejemplo de respuesta
Una solicitud correcta generará una respuesta como la siguiente:
Carga local
Para crear un archivo mediante carga local, seleccione el punto final Create File (local upload). El cuerpo de la solicitud requiere el nombre del archivo y el tamaño del archivo especificado en bytes.
Ejemplo de solicitud
Ejemplo de respuesta
Si la solicitud se completa correctamente, se crea un recurso de archivo marcador de posición sin contenido. En función del tamaño del archivo, el cuerpo de la respuesta incluirá una o varias upload_urls. En este ejemplo, tendremos que gestionar la carga en varias partes.
Requisitos importantes de carga:
Estos son detalles importantes que debe tener en cuenta al enviar las solicitudes de carga posteriores:
- El método de petición HTTP debe ser
PUT - Debe incluirse el encabezado
x-amz-acly definirse como privado - El encabezado
Content-Typedebe coincidir con el valormedia_typeespecificado en la solicitud Create File (local upload) original. Esto también se aplica al cargar el archivo en partes independientes. En el ejemplo anterior, el valor demedia_typeesimage/jpeg. Por lo tanto, el valor deContent-Typetambién debe serimage/jpeg.
Carga de varias partes
Cuando un archivo determinado genera más de una URL de carga, deberá dividir el archivo de origen en fragmentos y emitir una solicitud PUT para cada uno.
Recomendado: La Guía de carga del SDK para Python cubre la carga de varias partes con FrameioUploader, que gestiona de forma integrada la fragmentación, las cargas paralelas, los reintentos y el seguimiento de progreso.
Si necesita implementar la carga manualmente, por ejemplo, en un lenguaje sin SDK o para tener control total sobre el proceso, el siguiente script muestra cómo dividir un archivo en fragmentos y cargar cada uno con las URL con firma previa.
Ejemplo de implementación de Python
Resumen del flujo de carga
Elección del método de carga
Decida entre carga remota, si se puede acceder al archivo mediante una URL, o carga local, si el archivo está en el sistema
Creación de solicitud de archivo
Realice la solicitud inicial para crear el recurso de archivo con los metadatos obligatorios
Gestión de URL de carga
En las cargas locales, procese las upload_urls devueltas, ya sea una sola parte o varias
Siguientes pasos: Una vez cargado el archivo, puede usar el ID de archivo devuelto para añadir comentarios, crear elementos de uso compartido o realizar otras operaciones mediante la API V4 de Frame.io.