Statut du conteneur média Instagram : codes et cycle de vie
L'API Instagram publie via des conteneurs média, et chacun renvoie un status_code : IN_PROGRESS tant qu'il est en cours de publication, FINISHED lorsqu'il est prêt, PUBLISHED une fois en ligne, ERROR s'il n'a pas pu aboutir et EXPIRED si 24 heures se sont écoulées sans publication. Meta recommande de vérifier une fois par minute, pendant 5 minutes au maximum.
easyCoexistence gère le cycle des conteneurs dans publish_instagram_post : il crée le conteneur, attend qu'Instagram termine, puis publie.
Valeurs que peut prendre status_code : IN_PROGRESS, FINISHED, PUBLISHED, ERROR et EXPIRED.
Durée pendant laquelle un conteneur peut rester non publié avant que son statut passe à EXPIRED.
Intervalle recommandé par Meta entre deux vérifications du statut, pendant 5 minutes au maximum.
Conteneurs qu'un compte Instagram peut créer sur une fenêtre glissante de 24 heures.
Sous-code d'erreur, sous le code 9007, pour la publication d'un conteneur qui n'est pas encore prêt.
Qu'est-ce qu'un conteneur média ?
L'objet à partir duquel une publication est créée. POST /<IG_ID>/media en crée un à partir d'une URL d'image ou de vidéo : Meta récupère le média et le prépare, puis POST /<IG_ID>/media_publish, avec l'ID du conteneur comme creation_id, le transforme en publication. Un carrousel ajoute un niveau : un conteneur par élément, puis un conteneur CAROUSEL qui les liste comme enfants.
Que signifie chaque code de statut ?
GET /<IG_CONTAINER_ID>?fields=status_code renvoie l'une de cinq valeurs, chacune avec sa propre étape suivante :
IN_PROGRESS: le conteneur est encore en cours de publication ; patientez et vérifiez à nouveau.- FINISHED : le conteneur et son média sont prêts ; publiez-le.
- PUBLISHED : le média est déjà en ligne ; il n'y a plus rien à publier.
- ERROR : le conteneur n'a pas pu aller au bout du processus de publication ; le champ status contient un sous-code d'erreur qui indique la cause, et un nouveau conteneur est nécessaire.
- EXPIRED : il n'a pas été publié dans les 24 heures ; créez-en un nouveau.
GET https://graph.instagram.com/<IG_CONTAINER_ID>?fields=status_code
{
"status_code": "FINISHED",
"id": "<IG_CONTAINER_ID>"
}À quelle fréquence vérifier le statut ?
Une fois par minute, pendant 5 minutes au maximum, selon la recommandation de Meta. La vérification compte surtout pour la vidéo : Meta précise que les envois de vidéo sont asynchrones. Recevoir un ID de conteneur ne garantit pas que l'envoi a réussi ; c'est un status_code égal à FINISHED qui le confirme.
Que se passe-t-il si vous publiez trop tôt ?
media_publish échoue avec le code 9007, sous-code 2207027 : le média n'est pas prêt à être publié. Rien dans la requête n'est à corriger ; vérifiez le statut et publiez une fois qu'il affiche FINISHED. Le code 24 avec le sous-code 2207008 est différent : il signale un conteneur inexistant ou expiré, et Meta suggère de réessayer une ou deux fois, entre 30 secondes et 2 minutes, avant de créer un nouveau conteneur.
Combien de temps dure un conteneur ?
24 heures. Un conteneur non publié dans ce délai passe à EXPIRED et ne peut plus être publié. Le code -2 avec le sous-code 2207020 (le média a expiré) demande lui aussi un nouveau conteneur. Un compte peut créer 400 conteneurs sur une fenêtre glissante de 24 heures, ce qui laisse la place d'en recréer un après un échec.
Que signale d'autre un conteneur ?
Deux champs supplémentaires, et une remarque issue de la publication. status contient un sous-code d'erreur chaque fois que status_code affiche ERROR. copyright_check_status indique, pour une vidéo, si le contrôle de droits d'auteur de Meta a été effectué et s'il a trouvé des correspondances. Après la publication, media_publish peut renvoyer config_issue, CAPTION_NOT_ATTACHED ou USER_TAGGING_FAILURE, lorsque la publication est en ligne sans sa légende ou sans ses mentions d'utilisateurs.
Erreurs courantes
- Prendre l'ID d'un conteneur pour un envoi terminé. Les envois de vidéo sont asynchrones, et seul un status_code égal à FINISHED confirme que le média est prêt.
- Publier alors que le statut affiche IN_PROGRESS. L'appel échoue avec le sous-code 2207027 tant qu'il n'affiche pas FINISHED.
- Garder un conteneur plus d'une journée. Après 24 heures sans publication, il affiche EXPIRED, et seul un nouveau conteneur peut être publié.
- Ne lire que status_code en cas d'échec. Lorsqu'il affiche ERROR, le champ status porte le sous-code qui désigne la cause.
Tant qu'une vidéo est encore en traitement, il termine la publication de lui-même. Claude, ChatGPT ou votre propre code reçoivent l'ID du média publié, ou un statut de traitement pendant qu'easyCoexistence la termine. De US$ 9 à US$ 0,75 par connexion et par mois, un tarif qui baisse à mesure que vous ajoutez des connexions, avec les 3 premiers jours offerts.
Questions fréquemment posées
Que signifie IN_PROGRESS sur un conteneur Instagram ?
Meta prépare encore le média. Attendez et vérifiez à nouveau, car publier avant que le statut affiche FINISHED échoue avec le code 9007.
Combien de conteneurs média un compte Instagram peut-il créer ?
400 sur une fenêtre glissante de 24 heures, ce qui laisse la place d'en recréer un après un échec.
Que signifie config_issue après une publication ?
media_publish a réussi, mais la publication est en ligne sans sa légende, CAPTION_NOT_ATTACHED, ou sans ses mentions d'utilisateurs, USER_TAGGING_FAILURE.
Pourquoi mon conteneur s'est-il terminé en ERROR ?
Il n'a pas pu aller au bout du processus de publication. Son champ status contient un sous-code d'erreur qui indique la raison ; corrigez cette cause et créez un nouveau conteneur.
Poursuivre la lecture
Connectez votre premier canal en deux minutes.
Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.
- 3 jours gratuits
- Résiliable à tout moment
- API officielles uniquement
- Supervisé 24/7
Vérifié le