Saltar al contenido principal
GET
Para subidas de archivos mayores a 10 MB, obtén una URL prefirmada para cargar el archivo.
  • 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.
Si ya tienes tu medio accesible mediante una URL externa, como un bucket de S3, puedes omitir la subida de los archivos a Ayrshare. Simplemente haz POST al endpoint /post con tu URL accesible externamente en el parámetro del body mediaURLs y tu archivo se subirá automáticamente.

Parámetros del header

Parámetros de query

fileName
string
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.
contentType
string
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

  • accessUrl es la URL para acceder al archivo de medio después de la subida.
  • contentType es el content-type establecido para el medio que se está subiendo. Úsalo en el header Content-Type al subir el medio.
  • uploadUrl es 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 uploadURL y una accessURL mediante el endpoint /media/uploadUrl. Consulta arriba.
  • Sube el archivo mediante un PUT con Content-Type igual al contentType devuelto.
  • Sube el medio usando --upload-file con un archivo de medio y la uploadUrl.
  • Si la subida es exitosa, se devolverá una respuesta 200.
  • Después de subir el archivo de medio, haz POST al endpoint /post con la accessUrl en el parámetro del body mediaUrls.
  • 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.
Asegúrate de que el 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 la uploadUrl. En Postman:
  1. Selecciona el método HTTP PUT.
  2. Pega tu uploadUrl en 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 la uploadUrl.
  3. En Headers establece Content-Type con el content type devuelto por el endpoint /uploadUrl. Por ejemplo: Content-Type: image/png.
  4. Selecciona Body -> binary y elige el archivo a subir.
  5. Presiona Send.
  6. Importante: no se devolverá ninguna respuesta, por lo que debes comprobar si la subida fue exitosa abriendo la accessUrl devuelta por el endpoint /uploadUrl en un navegador. También puedes usar el endpoint de verificación de URL.
Postman Binary Upload

Postman Sample JSON File