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 media e um processo de dois passos: primeiro solicite um URL de envio pre-assinado e depois envie o seu ficheiro diretamente para esse URL. Isto mantem os seus ficheiros seguros e permite envios de grande dimensao.

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

Solicite URLs de envio pre-assinados para um ou mais ficheiros. Pode solicitar ate 20 URLs numa unica chamada.

Chave API (Bearer token)

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

Parametros do Corpo

Parametro	Tipo	Descricao
`files`OBRIGATORIO	`FileUploadRequest[]`	Array de metadados de ficheiros (1-20 itens)
`files[].fileName`OBRIGATORIO	`string`	Nome original do ficheiro
`files[].mimeType`OBRIGATORIO	`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 ficheiro em fileName

Passo 1: Obter URLs de Envio

Envie um pedido POST com os metadados do ficheiro para receber URLs de envio pre-assinados. Consulte o painel de codigo para um exemplo de pedido e resposta.

Passo 2: Enviar o Ficheiro

Utilize o uploadUrl da resposta para enviar o seu ficheiro atraves de um pedido PUT. Consulte o painel de codigo para um exemplo.

Passo 3: Utilizar numa Publicacao

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.

Expiracao do URL de envio

Os URLs pre-assinados expiram apos 1 hora. Envie o seu ficheiro 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 ficheiro

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"
    }
  ]
}