Saltar al contenido principal
POST
Este endpoint te permite subir un archivo, imagen o video pequeño para incluir en tu publicación. Devuelve la URL de la imagen que puede utilizarse en el endpoint /post. Puedes enviar el archivo como multipart form data mediante un parámetro de formulario, o como un archivo codificado en Base64 mediante un parámetro del cuerpo. Notas importantes sobre la subida de archivos multimedia:
  1. Para obtener el mejor rendimiento, recomendamos:
    • Alojar los archivos multimedia en tu propio servidor (p. ej., AWS S3).
    • Pasar la URL del archivo directamente en el parámetro mediaUrls del endpoint /post.
    • Este enfoque es más rápido que subir archivos a través de este endpoint.
  2. Retención de archivos multimedia
    • Los archivos subidos se almacenan durante 90 días.
    • Después de 90 días:
      • Las publicaciones ya publicadas en las redes sociales no se ven afectadas.
      • Las publicaciones programadas fallarán al publicarse si hacen referencia a contenido multimedia caducado.
  3. Límites de tamaño de archivo
Si ya tienes tu contenido multimedia accesible a través de una URL externa, como un bucket de S3, puedes omitir la subida de los archivos a Ayrshare. Simplemente realiza un POST al endpoint /post con tu URL accesible externamente en el parámetro mediaURLs del cuerpo y el archivo se subirá automáticamente.

Parámetros de cabecera

Content-Type
string
requerido
Usa multipart/form-data si envías datos de formulario multipart; consulta a continuación. En caso contrario, envía el estándar application/json.

Parámetros del cuerpo

file
string or object
requerido
Tamaño máximo del archivo: 30 MB.Recomendamos enviarlo como un objeto multipart form-data en lugar de codificarlo en Base64.
fileName
string
El nombre del archivo que se va a subir.
description
string
Una descripción del archivo.

Envío como Multipart Form-Data

Envía el archivo multimedia como un objeto multipart form-data. Asegúrate de especificar el Content-Type tal como se indica más arriba.

Envío como Base64

Envía el archivo multimedia como una cadena codificada en Base64 en formato Data URI. La cadena debe comenzar con data:content/type;base64 Ejemplo de codificación con formato de salida Data URI: Nota: el endpoint /post acepta archivos más grandes a través de una URL externa con el parámetro mediaUrls.