Erreurs de l'API Instagram : ce que signifient les codes courants
Les erreurs les plus fréquentes de l'API Instagram sont 190 pour un token expiré ou invalide, 4, 17 et 80002 pour les limites de débit, 9004 pour un média que Meta ne peut pas récupérer, 9007 pour une vidéo encore en traitement, 9 pour le plafond quotidien de publication, et 10 avec le sous-code 2534022 pour un DM envoyé hors de la fenêtre de messagerie. Chacune arrive sous forme de JSON avec un code, souvent un sous-code qui précise le cas exact, et un message.
easyCoexistence prend en charge la partie connexion de ces erreurs : il renouvelle l'accès Instagram avant qu'il n'expire, vérifie le compte toutes les 6 heures et vous envoie un e-mail lorsqu'une reconnexion est nécessaire.
Code de l'API Graph pour un token d'accès expiré, révoqué ou autrement invalide.
Code d'erreur pour la limite de débit Business Use Case d'Instagram.
Sous-code du code 9 pour un compte ayant atteint sa limite quotidienne de publication via l'API.
Sous-code du code 9004 pour un média que Meta n'a pas pu récupérer à partir de l'URL indiquée.
Sous-code du code 200 lorsque le compte a désactivé l'accès à ses messages Instagram.
Comment lire une erreur de l'API Instagram ?
Chaque erreur est un objet JSON placé sous error. code désigne la catégorie générale, error_subcode précise le cas exact et est généralement le plus utile des deux, et message la décrit. Beaucoup d'erreurs contiennent aussi error_user_title et error_user_msg, des textes destinés à la personne, ainsi que is_transient. fbtrace_id identifie la requête auprès du support de Meta et expire rapidement ; enregistrez-le donc au moment de l'erreur.
Que signifient les erreurs d'accès et d'autorisation ?
Erreurs sur qui peut faire quoi, avec le correctif pour chacune :
- 190 : le token d'accès a expiré, été révoqué ou est autrement invalide ; le sous-code 463 signifie expiré, 467 invalide et 460 un mot de passe modifié. Un nouveau token règle le problème, ce qui, pour un compte connecté, implique de le reconnecter.
- 10 : permission refusée. Une autorisation n'a jamais été accordée ou a été retirée depuis.
- 200 à 299 : une autorisation précise manque, par exemple 200 avec le sous-code 2534041 lorsque le compte a désactivé l'accès à ses messages.
- 25, sous-code 2207050 : le compte est restreint, inactif ou soumis à une vérification ; le titulaire doit se connecter à l'application Instagram et accomplir ce qu'elle demande.
Que signifient les erreurs de limite de débit ?
Un bridage, entièrement temporaire :
- 4 : trop d'appels depuis l'application ; attendez puis relancez, ou réduisez le volume de requêtes.
- 17 : trop d'appels pour l'utilisateur ; le même remède s'applique.
- 80002 : la limite Business Use Case d'Instagram, calculée par application et par compte à partir des impressions du compte : 4 800 appels par impression sur 24 heures.
- 613, sous-code 2534040 : trop d'appels de messagerie ; mettez en pause et réessayez plus tard.
Que signifient les erreurs de publication liées au média ?
Erreurs concernant le fichier et son hébergement ; seul le délai d'expiration vaut d'être relancé en l'état :
- 9004, sous-code 2207052 : Meta n'a pas pu récupérer le média depuis l'URL ; vérifiez qu'elle est valide et publique.
- -2, sous-code 2207003 : le téléchargement a pris trop de temps ; cette erreur vaut la peine d'être relancée.
- 36000, sous-code 2207004 : l'image dépasse 8 Mo.
- 36001, sous-code 2207005 : le format d'image n'est pas pris en charge ; utilisez du JPEG.
- 36003, sous-code 2207009 : le ratio d'aspect se situe en dehors de 4:5 à 1,91:1.
- 352, sous-code 2207026 : le format vidéo n'est pas pris en charge ; utilisez MOV ou MP4.
Que signifient les erreurs de publication liées au moment et aux limites ?
Erreurs sur le quand et le combien, dont la plupart se règlent en attendant ou en recommençant :
- 9007, sous-code 2207027 : le média n'est pas prêt ; attendez que le
status_codedu conteneur indique FINISHED. - 24, sous-code 2207008 : le conteneur n'existe pas ou a expiré ; réessayez une ou deux fois entre 30 secondes et 2 minutes, puis créez-en un nouveau.
- -2, sous-code 2207020 : le média a expiré ; créez un nouveau conteneur.
- 9, sous-code 2207042 : le compte a atteint sa limite quotidienne de publication ; réessayez le lendemain.
- 100, sous-code 2207028 : un carrousel doit comporter de 2 à 10 éléments.
- 36004, sous-code 2207010 : la légende est trop longue ; les limites de Meta sont de 2 200 caractères et 20 mentions @, et sa référence indique 30 hashtags, bien qu'Instagram en autorise 5 par publication.
- 4, sous-code 2207051 : Instagram a restreint l'action, soupçonnée d'être du spam.
Que signifient les erreurs de messagerie ?
Erreurs liées aux DM et aux réponses privées :
- 10, sous-code 2534022 : le message a été envoyé hors de la fenêtre autorisée ; attendez que la personne vous réécrive.
- 100, sous-code 2534014 : aucun utilisateur Instagram correspondant ; utilisez l'ID à portée Instagram issu du webhook, et non un ID d'utilisateur Instagram.
- 100, sous-code 2534025 : le commentaire ne peut pas recevoir de réponse privée.
- 100, sous-code 2534037 : une autre application, y compris Business AI de Meta, contrôle la conversation.
- 551, sous-code 1545041 : la personne n'est pas disponible pour le moment.
Que signifient les erreurs d'insights ?
Les requêtes d'insights échouent de trois manières documentées :
- 10, lorsque le média n'a pas assez de spectateurs pour afficher des insights : une métrique de Story inférieure à 5.
- Une métrique retirée, comme les impressions depuis le 21 avril 2025, renvoie une erreur ; demandez plutôt views.
- Une erreur inconnue lorsque l'une des métriques demandées ne prend pas en charge la ventilation demandée.
Quelles erreurs valent la peine d'être relancées ?
Seulement les erreurs temporaires : les codes 1 et 2, les erreurs serveur d'Instagram 2207001 et 2207032, le délai de téléchargement 2207003, le 2207008 lorsqu'il est passager, et les limites de débit une fois l'attente écoulée. Toutes les autres renvoient la même réponse tant que quelque chose ne change pas : le fichier, l'URL, une autorisation, l'état du compte ou la fenêtre de la personne. Les relancer ne fait que consommer la limite de débit.
Erreurs courantes
- Relancer une erreur de format ou de taille. 2207004, 2207005, 2207009 et 2207026 échouent de la même façon tant que le média ne change pas.
- Traiter 9007 comme un échec. La vidéo est encore en traitement ; publiez lorsque le conteneur indique FINISHED.
- Ne lire que le code. Des codes comme 10 et 100 couvrent plusieurs cas, et c'est le sous-code qui précise lequel.
- Ne pas garder fbtrace_id dans les journaux. Le support de Meta le demande, et il expire peu après l'erreur.
Claude, ChatGPT ou votre propre code appellent ensuite l'API officielle de Meta avec un token maintenu à jour. De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.
Questions fréquemment posées
Que signifie l'erreur 190 sur Instagram ?
Le token d'accès a expiré, été révoqué ou est autrement invalide, par exemple après une modification du mot de passe. Un nouveau token règle le problème ; pour un compte connecté, cela signifie le reconnecter.
Pourquoi la publication échoue-t-elle avec 9004 ?
Meta n'a pas pu récupérer le média depuis l'URL indiquée, sous-code 2207052. Vérifiez que le lien est valide et public, sans connexion exigée, au moment de la publication.
Que signifie l'erreur 9007 ?
La vidéo du conteneur est encore en traitement, sous-code 2207027. Vérifiez le status_code du conteneur et publiez une fois qu'il indique FINISHED.
Qu'est-ce que fbtrace_id dans une erreur de l'API Instagram ?
Un identifiant de la requête en échec, que le support de Meta demande lorsque vous signalez un problème. Il expire peu après l'erreur ; notez-le donc dans vos journaux au moment où elle se produit.
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