REST APIPOST

Importation de médias

Importez des images et des vidéos vers AdaptlyPost via des URLs pré-signées, puis attachez les IDs de médias aux publications.

L'envoi de médias est un processus en deux étapes : demandez d'abord une URL d'envoi pré-signée, puis envoyez votre fichier directement à cette URL. Cela garantit la sécurité de vos fichiers et permet des envois volumineux.

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

Demandez des URL d'envoi pré-signées pour un ou plusieurs fichiers. Vous pouvez demander jusqu'à 20 URL en un seul appel.

Clé API (jeton Bearer)

Permission:media.uploadRôles et permissions

Paramètres du corps

Paramètre	Taper	Description
`files`REQUIS	`FileUploadRequest[]`	Tableau de métadonnées de fichiers (1 à 20 éléments)
`files[].fileName`REQUIS	`string`	Nom original du fichier
`files[].mimeType`REQUIS	`string`	image/jpeg, image/png, image/webp, video/mp4, video/quicktime ou un type de document pour les publications DOCUMENT LinkedIn (PDF, PPT, PPTX, DOC, DOCX ; voir Formats pris en charge). Gardez l'extension du fichier dans fileName

Étape 1 : Obtenir les URL d'envoi

Envoyez une requête POST avec les métadonnées du fichier pour recevoir des URL d'envoi pré-signées. Consultez le panneau de code pour un exemple de requête et de réponse.

Étape 2 : Envoyer le fichier

Utilisez l'uploadUrl de la réponse pour envoyer votre fichier via une requête PUT. Consultez le panneau de code pour un exemple.

Étape 3 : Utiliser dans une publication

Passez la publicUrl de la réponse d'upload comme entrée de mediaUrls lors de la création d'une publication. Une publicUrl peut être réutilisée dans autant de publications que vous voulez ; le fichier est conservé jusqu'à ce que la dernière publication qui le référence soit publiée. Réutilisez la publicUrl que vous avez uploadée, pas une valeur de mediaUrls lue depuis une publication déjà publiée, car il peut s'agir de liens de plateforme qui expirent.

Expiration de l'URL d'envoi

Les URL pré-signées expirent après 1 heure. Envoyez votre fichier avant l'horodatage expiresAt ou demandez une nouvelle URL.

Formats pris en charge

Taper	Types MIME
Images	`image/jpeg`, `image/png`, `image/webp`
Vidéos	`video/mp4`, `video/quicktime`
Documents (LinkedIn)	`application/pdf`, `application/vnd.ms-powerpoint`, `application/vnd.openxmlformats-officedocument.presentationml.presentation`, `application/msword`, `application/vnd.openxmlformats-officedocument.wordprocessingml.document`

Obtenir les URL d'envoi

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

Envoyer le fichier

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