REST APIPOST

Carga de medios

Sube imágenes y vídeos a AdaptlyPost con URLs prefirmadas y adjunta los IDs de medios devueltos a cualquier publicación.

La subida de medios es un proceso de dos pasos: primero solicite una URL de subida prefirmada, luego suba su archivo directamente a esa URL. Esto mantiene sus archivos seguros y permite subidas de gran tamaño.

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

Solicite URLs de subida prefirmadas para uno o más archivos. Puede solicitar hasta 20 URLs en una sola llamada.

Clave API (token Bearer)

Permiso:media.uploadRoles y permisos

Parámetros del cuerpo

Parámetro	Tipo	Descripción
`files`OBLIGATORIO	`FileUploadRequest[]`	Array de metadatos de archivos (1-20 elementos)
`files[].fileName`OBLIGATORIO	`string`	Nombre original del archivo
`files[].mimeType`OBLIGATORIO	`string`	image/jpeg, image/png, image/webp, video/mp4, video/quicktime o un tipo de documento para publicaciones DOCUMENT de LinkedIn (PDF, PPT, PPTX, DOC, DOCX; consulte Formatos compatibles). Mantén la extensión del archivo en fileName

Paso 1: Obtener URLs de subida

Envíe una solicitud POST con los metadatos del archivo para recibir URLs de subida prefirmadas. Consulte el panel de código para ver un ejemplo de solicitud y respuesta.

Paso 2: Subir el archivo

Utilice la uploadUrl de la respuesta para subir su archivo mediante una solicitud PUT. Consulte el panel de código para ver un ejemplo.

Paso 3: Usar en una publicación

Pasa la publicUrl de la respuesta de subida como entrada de mediaUrls al crear una publicación. Puedes reutilizar una publicUrl en tantas publicaciones como quieras; el archivo se conserva hasta que la última publicación que lo referencia se haya publicado. Reutiliza la publicUrl que subiste, no un valor de mediaUrls leído de una publicación ya publicada, ya que pueden ser enlaces de plataforma que caducan.

Expiración de la URL de subida

Las URLs prefirmadas expiran después de 1 hora. Suba su archivo antes de la marca de tiempo expiresAt o solicite una nueva URL.

Formatos compatibles

Tipo	Tipos MIME
Imágenes	`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`

Obtener URLs de subida

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

Subir archivo

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