Pular para o conteúdo principal
POST
Este endpoint permite fazer upload de um arquivo, uma imagem ou um vídeo pequeno para incluir em sua publicação. Será retornada a URL da imagem que pode ser usada no endpoint /post. Você pode enviar o arquivo como multipart form data como parâmetro de formulário ou como arquivo codificado em Base64 como parâmetro do corpo. Notas importantes sobre uploads de mídia:
  1. Para melhor desempenho, recomendamos
    • Hospedar arquivos de mídia em seu próprio servidor (por exemplo, AWS S3).
    • Passar a URL da mídia diretamente no parâmetro mediaUrls do endpoint /post.
    • Essa abordagem é mais rápida do que fazer upload de arquivos por este endpoint.
  2. Retenção de arquivos de mídia
    • Arquivos enviados são armazenados por 90 dias.
    • Após 90 dias:
      • Publicações já publicadas nas redes sociais não são afetadas.
      • Publicações agendadas falharão ao publicar se referenciarem mídia expirada.
  3. Limites de tamanho de arquivo
Se você já tem sua mídia acessível por uma URL externa, como um bucket S3, é possível pular o upload dos arquivos para a Ayrshare. Basta fazer um POST para o endpoint /post com sua URL acessível externamente no parâmetro mediaURLs do corpo e o arquivo será enviado automaticamente.

Parâmetros do header

Content-Type
string
obrigatório
Use multipart/form-data se estiver enviando dados de formulário multipart - veja abaixo. Caso contrário, envie o padrão application/json.

Parâmetros do body

file
string or object
obrigatório
Tamanho máximo do arquivo de 30 MB.Recomendamos enviar como um objeto multipart form-data em vez de codificação Base64.
fileName
string
O nome do arquivo a ser enviado.
description
string
Uma descrição do arquivo.

Enviar como Multipart Form-Data

Envie o arquivo de mídia como um objeto multipart form-data. Certifique-se de especificar o Content-Type conforme mencionado acima.

Enviar como Base64

Envie o arquivo de mídia como uma string codificada em Base64 no formato Data URI. A string deve começar com data:content/type;base64 Exemplos de codificação com formato de saída Data URI: Observação: o endpoint /post aceita arquivos maiores via uma URL externa com o parâmetro mediaUrls.