Pular para o conteúdo principal
GET
Para uploads de arquivos maiores que 10 MB, obtenha uma URL pré-assinada para fazer o upload de um arquivo.
  • Tamanho máximo de upload: 5 GB.
  • URL pré-assinada de upload válida por 30 minutos após ser gerada.
  • URL de acesso disponível por 30 dias após o upload. Todas as publicações já publicadas não são afetadas nas redes sociais. Publicações agendadas além desse período resultarão em erros no momento da publicação.
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

Parâmetros de query

fileName
string
Se o contentType não estiver presente, então um nome de arquivo completo com extensão é obrigatório.Nome do arquivo a ser enviado. Deve incluir uma extensão como .png, .jpg, .mov, .mp4, etc.
contentType
string
O content-type da mídia que está sendo enviada. Formatos válidos incluem: mp4, mov, png, jpg ou jpeg.Por exemplo, se o arquivo for um Quicktime .mov, então o contentType deve ser mov.Se não estiver presente, será utilizado application/octet-stream.

Detalhes da resposta

  • accessUrl é a URL para acessar o arquivo de mídia após o upload.
  • contentType é o content-type definido para a mídia que está sendo enviada. Use-o no header Content-Type ao fazer o upload da mídia.
  • uploadUrl é a URL usada para fazer o PUT do arquivo de mídia. Veja abaixo.

Exemplos adicionais de endpoint

O processo para fazer upload de arquivos maiores:
  • Obtenha uma uploadURL e accessURL pelo endpoint /media/uploadUrl. Veja acima.
  • Faça o upload do arquivo via um PUT com Content-Type definido como o contentType retornado.
  • Faça o upload da mídia usando --upload-file com um arquivo de mídia e a uploadUrl.
  • Em um upload bem-sucedido, será retornada uma resposta 200.
  • Após fazer o upload do arquivo de mídia, faça um POST para o endpoint /post com a accessUrl no parâmetro mediaUrls do corpo.
  • A URL de upload pré-assinada só pode receber upload uma única vez. Se você enviou um arquivo incorreto, precisará criar uma nova URL de upload. Nenhuma resposta de erro ocorrerá se o arquivo não for enviado com sucesso. Veja abaixo como verificar se a URL existe.
Certifique-se de que o contentType definido ao criar a uploadUrl corresponda ao Content-Type e ao tipo do arquivo ao fazer o PUT do arquivo. Por exemplo, se você definir o contentType como “image/png” ao criar a uploadUrl, certifique-se de definir Content-Type: image/png e que o arquivo enviado termine em .png. Em um upload bem-sucedido, será retornada uma resposta 200.

Exemplo de upload de arquivo binário em Node.js

Aqui está um exemplo de upload de um arquivo de mídia binário usando Node com JavaScript:

Exemplo de upload de arquivo binário no Postman

Você também pode usar o Postman para fazer o upload do arquivo binário para a uploadUrl. No Postman:
  1. Selecione o método HTTP PUT.
  2. Cole sua uploadUrl no campo de URL. Observe que a URL expira após uma hora e só pode ser usada uma vez. Se você fizer uma chamada e ela falhar, será necessário regenerar a uploadUrl.
  3. Em Headers, defina o Content-Type como o content type retornado no endpoint /uploadUrl. Por exemplo: Content-Type: image/png.
  4. Selecione Body -> binary e escolha o arquivo a ser enviado.
  5. Pressione Send.
  6. Importante: nenhuma resposta será retornada, portanto você deve verificar se o upload foi bem-sucedido abrindo a accessUrl retornada pelo endpoint /uploadUrl em um navegador. Você também pode usar o endpoint de verificação de URL.
Postman Binary Upload

Arquivo JSON de exemplo do Postman