Media
Subir archivos de medios grandes
Para subidas de archivos mayores a 10 MB, obtén una URL prefirmada para cargar el archivo
GET
Para subidas de archivos mayores a 10 MB, obtén una URL prefirmada para cargar el archivo.
Asegúrate de que el

- Tamaño máximo de archivo: 5 GB.
- La URL prefirmada de subida es válida durante 30 minutos después de generarse.
- La URL de acceso está disponible durante 30 días después de la subida. Las publicaciones ya publicadas no se verán afectadas en las redes sociales. Las publicaciones programadas más allá de ese plazo generarán errores en el momento de la publicación.
Parámetros del header
Parámetros de query
Si contentType no está presente, entonces se requiere un nombre de archivo completo con extensión.Nombre del archivo a subir. Debe incluir una extensión como .png, .jpg, .mov, .mp4, etc.
El content-type del medio que se está subiendo. Los formatos válidos incluyen:
mp4, mov, png, jpg o jpeg.Por ejemplo, si el archivo es un .mov de Quicktime, entonces contentType debe ser mov.Si no está presente, se usará application/octet-stream.Detalles de la respuesta
accessUrles la URL para acceder al archivo de medio después de la subida.contentTypees el content-type establecido para el medio que se está subiendo. Úsalo en el header Content-Type al subir el medio.uploadUrles la URL utilizada para hacer PUT del archivo de medio. Consulta a continuación.
Ejemplos adicionales del endpoint
El proceso para subir archivos más grandes:- Obtén una
uploadURLy unaaccessURLmediante el endpoint/media/uploadUrl. Consulta arriba. - Sube el archivo mediante un PUT con Content-Type igual al
contentTypedevuelto. - Sube el medio usando
--upload-filecon un archivo de medio y lauploadUrl. - Si la subida es exitosa, se devolverá una respuesta
200. - Después de subir el archivo de medio, haz POST al endpoint
/postcon laaccessUrlen el parámetro del bodymediaUrls. - La URL de subida prefirmada solo puede utilizarse para subir una vez. Si enviaste un archivo incorrecto, debes crear una nueva URL de subida. No se devolverá ninguna respuesta de error si el archivo no se sube correctamente. Consulta a continuación cómo verificar que la URL existe.
contentType establecido al crear la uploadUrl coincida con el Content-Type y el tipo de archivo al hacer PUT del archivo.
Por ejemplo, si estableces contentType como “image/png” al crear la uploadUrl, asegúrate de establecer Content-Type: image/png y de que el archivo subido termine en .png.
Si la subida es exitosa, se devolverá una respuesta 200.
Ejemplo de subida de archivo binario en Node.js
Aquí tienes un ejemplo de cómo subir un archivo de medio binario usando Node con JavaScript:Ejemplo de subida de archivo binario en Postman
También puedes usar Postman para subir el archivo binario a lauploadUrl.
En Postman:
- Selecciona el método HTTP
PUT. - Pega tu
uploadUrlen el campo URL. Ten en cuenta que la URL expirará después de una hora y solo puede utilizarse una vez. Si haces una llamada y falla, debes regenerar lauploadUrl. - En Headers establece
Content-Typecon el content type devuelto por el endpoint /uploadUrl. Por ejemplo:Content-Type: image/png. - Selecciona Body -> binary y elige el archivo a subir.
- Presiona Send.
- Importante: no se devolverá ninguna respuesta, por lo que debes comprobar si la subida fue exitosa abriendo la
accessUrldevuelta por el endpoint /uploadUrl en un navegador. También puedes usar el endpoint de verificación de URL.

