REST APIPOST

Upload de Mídia

Faça upload de imagens e vídeos usando URLs pré-assinadas

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)

Parametros do Corpo

ParametroTipoDescricao
filesOBRIGATORIOFileUploadRequest[]Array de metadados de ficheiros (1-20 itens)
files[].fileNameOBRIGATORIOstringNome original do ficheiro
files[].mimeTypeOBRIGATORIOstringimage/jpeg, image/png, image/webp, video/mp4 ou video/quicktime

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 o publicUrl da resposta de envio como uma entrada mediaUrls ao criar uma publicacao.

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

TipoTipos MIME
Imagensimage/jpeg, image/png, image/webp
Vídeosvideo/mp4, video/quicktime
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
200
{
  "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"
    }
  ]
}