REST APIPOST

Upload de Mídia

Faça upload de imagens e vídeos para o AdaptlyPost com URLs pré-assinadas e anexe os IDs de mídia a qualquer publicação.

O envio de mídia é um processo de dois passos: primeiro solicite um URL de envio pré-assinado e depois envie seu arquivo diretamente para esse URL. Isso mantém seus arquivos seguros e permite envios de grande tamanho.

POSThttps://post.adaptlypost.com/post/api/v1/upload-urls

Solicite URLs de envio pré-assinados para um ou mais arquivos. Você pode solicitar até 20 URLs em uma única chamada.

Chave API (Bearer token)

Permissão:media.uploadPapéis e permissões

Parâmetros do Corpo

Parâmetro	Tipo	Descrição
`files`OBRIGATÓRIO	`FileUploadRequest[]`	Array de metadados de arquivos (1-20 itens)
`files[].fileName`OBRIGATÓRIO	`string`	Nome original do arquivo
`files[].mimeType`OBRIGATÓRIO	`string`	image/jpeg, image/png, image/webp, video/mp4, video/quicktime ou um tipo de documento para publicações DOCUMENT do LinkedIn (PDF, PPT, PPTX, DOC, DOCX; consulte Formatos Suportados). Mantenha a extensão do arquivo em fileName

Passo 1: Obter URLs de Envio

Envie uma requisição POST com os metadados do arquivo para receber URLs de envio pré-assinados. Consulte o painel de código para um exemplo de requisição e resposta.

Passo 2: Enviar o Arquivo

Use o uploadUrl da resposta para enviar seu arquivo por meio de uma requisição PUT. Consulte o painel de código para um exemplo.

Passo 3: Usar em uma Publicação

Passe a publicUrl da resposta de upload como entrada de mediaUrls ao criar uma publicação. Você pode reutilizar uma publicUrl em quantas publicações quiser; o arquivo é mantido até que a última publicação que o referencia tenha sido publicada. Reutilize a publicUrl que você enviou, não um valor de mediaUrls lido de uma publicação já publicada, pois podem ser links de plataforma que expiram.

Expiração do URL de envio

Os URLs pré-assinados expiram após 1 hora. Envie seu arquivo antes do timestamp expiresAt ou solicite um novo URL.

Formatos Suportados

Tipo	Tipos MIME
Imagens	`image/jpeg`, `image/png`, `image/webp`
Vídeos	`video/mp4`, `video/quicktime`
Documentos (LinkedIn)	`application/pdf`, `application/vnd.ms-powerpoint`, `application/vnd.openxmlformats-officedocument.presentationml.presentation`, `application/msword`, `application/vnd.openxmlformats-officedocument.wordprocessingml.document`

Obter URLs de envio

curl --request POST \
  --url https://post.adaptlypost.com/post/api/v1/upload-urls \
  --header 'Authorization: Bearer <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
    "files": [
      {
        "fileName": "product-photo.jpg",
        "mimeType": "image/jpeg"
      }
    ]
  }'

Enviar arquivo

curl --request PUT \
  --url "https://storage.adaptlypost.com/presigned/abc123..." \
  --header 'Content-Type: image/jpeg' \
  --data-binary @product-photo.jpg

201

{
  "urls": [
    {
      "fileName": "product-photo.jpg",
      "uploadUrl": "https://storage.adaptlypost.com/presigned/abc123...",
      "publicUrl": "https://cdn.adaptlypost.com/uploads/product-photo.jpg",
      "key": "uploads/usr_001/product-photo.jpg",
      "expiresAt": "2026-03-14T13:00:00Z"
    }
  ]
}