REST API

Envoi de medias

Name: AdaptlyPost
Author: AdaptlyPost

Envoyez des images et des videos a l'aide d'URL pre-signees

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

Parametres du corps

Parametre	Type	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 ou video/quicktime

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

Transmettez la publicUrl de la reponse d'envoi comme entree mediaUrls lors de la creation d'une publication.

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

Type	Types MIME
Images	`image/jpeg`, `image/png`, `image/webp`
Videos	`video/mp4`, `video/quicktime`

Obtenir les URL d'envoi

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

Envoyer le fichier

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