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
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
| file_name | string | Oui | Le nom du fichier (255 caractères max). |
| size | integer | Oui | La taille exacte du fichier en octets, de 1 à 1073741824 (1 Go). |
| upload.part_size | integer | Non | Dans la réponse : les octets de chaque partie. La dernière porte le reste. |
| upload.parts | integer | Non | Dans la réponse : le nombre de parties du fichier, numérotées à partir de 1. |
| upload.expires_at | string | Non | Dans la réponse : jusqu'à quand l'envoi peut être terminé. Ensuite les parties sont supprimées. |
| received_parts | array | Non | Dans GET /media/uploads/{uuid} : les parties déjà reçues, pour reprendre un envoi interrompu. |
| url | string | Non | Quand status est ready : l'URL publique à utiliser dans media.url de POST /posts. |
| expires_at | string | Non | Quand 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.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
