REST API

Envio de Media

Name: AdaptlyPost
Author: AdaptlyPost

Envie imagens e videos utilizando URLs pre-assinados

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://api.adaptlypost.com/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

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 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

Tipo	Tipos MIME
Imagens	`image/jpeg`, `image/png`, `image/webp`
Videos	`video/mp4`, `video/quicktime`

Obter URLs de envio

curl --request POST \
  --url https://api.adaptlypost.com/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"
    }
  ]
}