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 medias est un processus en deux etapes : demandez d'abord une URL d'envoi pre-signee, puis envoyez votre fichier directement a cette URL. Cela garantit la securite de vos fichiers et permet des envois volumineux.

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

Demandez des URL d'envoi pre-signees pour un ou plusieurs fichiers. Vous pouvez demander jusqu'a 20 URL en un seul appel.

Cle API (jeton Bearer)

Permission:media.uploadRôles et permissions

Parametres du corps

Parametre	Taper	Description
`files`REQUIS	`FileUploadRequest[]`	Tableau de metadonnees de fichiers (1 a 20 elements)
`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

Etape 1 : Obtenir les URL d'envoi

Envoyez une requete POST avec les metadonnees du fichier pour recevoir des URL d'envoi pre-signees. Consultez le panneau de code pour un exemple de requete et de reponse.

Etape 2 : Envoyer le fichier

Utilisez l'uploadUrl de la reponse pour envoyer votre fichier via une requete PUT. Consultez le panneau de code pour un exemple.

Etape 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 pre-signees expirent apres 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"
    }
  ]
}