Posts

Envoyer de grandes vidéos à utiliser dans les posts via l'API

Les posts reçoivent le média par URL. Si vous n'avez nulle part où héberger le fichier, envoyez-le à Connect et obtenez une URL sur un domaine que les réseaux acceptent. Jusqu'à 8 Mo en une seule requête ; au-delà, la vidéo est envoyée en parties, jusqu'à 1 Go, et vous utilisez l'URL dans media.url de POST /posts.

L'appel

POST /api/media/uploads
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>

{
  "file_name": "reels-summer.mp4",
  "size": 52428800
}

Ce que vous pouvez faire

  • Envoyer un fichier de 8 Mo maximum en une requête avec POST /media.
  • Ouvrir un envoi en parties avec POST /media/uploads pour des fichiers jusqu'à 1 Go.
  • Envoyer les parties avec PUT /media/uploads/{uuid}/parts/{part}, en parallèle après la partie 1.
  • Reprendre un envoi interrompu : GET /media/uploads/{uuid} indique quelles parties sont arrivées.
  • Terminer avec POST /media/uploads/{uuid}/complete et obtenir l'URL prête à utiliser dans un post.

Règles et limites

  • POST /media accepte jusqu'à 8 Mo. Au-delà, il répond 413 media_too_large_for_single_upload et l'envoi se fait en parties.
  • Connect lit le type du fichier dans la partie 1. La partie 1 part en premier ; les autres peuvent partir dans n'importe quel ordre et en même temps. Renvoyer une partie remplace la précédente.
  • Chaque partie exige un Content-Length égal à sa taille exacte (upload.part_size, ou le reste pour la dernière). Sans lui, la réponse est 411.
  • Il accepte JPEG, PNG, WebP et GIF (images jusqu'à 30 Mo), MP4 et MOV (jusqu'à 1 Go). Le type vient du contenu, pas du nom, et le fichier entier est vérifié à la fin (422 media_content_invalid s'il n'est pas valide).
  • L'URL est valide jusqu'à expires_at, 30 jours après que le média est ready, puis le fichier est supprimé. Quiconque a le lien peut lire le fichier : ne le transmettez qu'à celui qui publie.
  • POST /media et POST /media/uploads exigent le header Idempotency-Key. 20 envois ouverts maximum par client.

Champs principaux

ChampTypeObligatoireDescription
file_namestringOuiLe nom du fichier (255 caractères max).
sizeintegerOuiLa taille exacte du fichier en octets, de 1 à 1073741824 (1 Go).
upload.part_sizeintegerNonDans la réponse : les octets de chaque partie. La dernière porte le reste.
upload.partsintegerNonDans la réponse : le nombre de parties du fichier, numérotées à partir de 1.
upload.expires_atstringNonDans la réponse : jusqu'à quand l'envoi peut être terminé. Ensuite les parties sont supprimées.
received_partsarrayNonDans GET /media/uploads/{uuid} : les parties déjà reçues, pour reprendre un envoi interrompu.
urlstringNonQuand status est ready : l'URL publique à utiliser dans media.url de POST /posts.
expires_atstringNonQuand l'URL cesse d'être valide et le fichier est supprimé : 30 jours après que le média est ready.

Pour qui

  • SaaS d'édition vidéo

    L'utilisateur exporte un Reels de 200 Mo ; le produit l'envoie en parties et publie sur Instagram et Facebook avec l'URL renvoyée.

  • Agence avec vidéos lourdes

    Le tableau de bord envoie les vidéos de campagne une fois et réutilise la même URL dans les posts de plusieurs réseaux.

  • Agent IA vidéo

    L'agent génère une vidéo, l'envoie à Connect en parties et passe l'URL à POST /posts sans rien héberger.

Fonctionne avec

  • Instagram Business
  • Facebook
  • YouTube
  • LinkedIn
  • Threads
  • Pinterest

Questions fréquentes

Quelle est la taille maximale ?

Jusqu'à 8 Mo en une seule requête (POST /media) et jusqu'à 1 Go en parties (POST /media/uploads). Les images sont limitées à 30 Mo.

Combien de temps l'URL reste-t-elle active ?

30 jours à partir du moment où le média est ready. Ensuite le fichier est supprimé : utilisez l'URL dans un post pendant ce délai.

Que se passe-t-il si l'envoi s'interrompt ?

Interrogez GET /media/uploads/{uuid} : received_parts liste les parties reçues. Envoyez uniquement les manquantes et terminez. L'envoi reste ouvert jusqu'à upload.expires_at.

Voir aussi

Voir tout ce que vous pouvez faire avec Posts

Voyez Connect appliqué à votre produit.

Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.