REST APIPOST

Importation de médias

Importez des images et vidéos en utilisant des URLs pré-signées

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)

Parametres du corps

ParametreTaperDescription
filesREQUISFileUploadRequest[]Tableau de metadonnees de fichiers (1 a 20 elements)
files[].fileNameREQUISstringNom original du fichier
files[].mimeTypeREQUISstringimage/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

TaperTypes MIME
Imagesimage/jpeg, image/png, image/webp
Vidéosvideo/mp4, video/quicktime
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
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"
    }
  ]
}