Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

Erreur 100 de l'API Instagram : paramètre invalide et média introuvable

L'erreur 100 de l'API Instagram signifie qu'un paramètre de la requête est invalide, et le sous-code précise le cas. Le sous-code 33 correspond à un média introuvable : l'ID de l'objet n'existe pas, ne peut pas être chargé avec les permissions du token ou ne prend pas en charge l'appel. Les autres sous-codes couvrent les types de média inconnus, les tailles de carrousel, les mentions @, les destinataires de DM et les recherches audio.

easyCoexistence renvoie l'erreur de Meta à Claude, ChatGPT ou à votre propre code lorsqu'un appel échoue, avec le statut HTTP, le code d'erreur de Meta et son message, afin que l'agent puisse corriger l'ID ou la valeur et réessayer.

Invalid parameter

Nom donné par Meta à l'erreur 100 de l'API Graph dans sa référence des erreurs de l'API Marketing.

33

Sous-code inférieur à 100 : l'ID de l'objet n'existe pas, ne peut pas être chargé faute de permissions, ou ne prend pas en charge l'opération.

2207023

Sous-code inférieur à 100 pour un type de média qu'Instagram ne connaît pas ; le conteneur doit porter l'un des types attendus.

2207040

Sous-code inférieur à 100 pour plus de 20 mentions @ sur un même média.

2534014

Sous-code inférieur à 100 pour un destinataire de DM sans utilisateur Instagram correspondant ; Meta attend l'ID à portée Instagram, et non l'ID utilisateur.

400

Statut HTTP que Meta indique pour chaque ligne de code 100 dans son tableau d'erreurs Instagram.

Que signifie l'erreur 100 sur Instagram ?

Un paramètre de la requête n'a pas pu être accepté. La référence de l'API Marketing de Meta nomme le code 100 « Invalid parameter », son tableau de messagerie l'appelle « Bad Parameter Error », et les lignes Instagram l'associent à un error_subcode et à un message utilisateur qui le précisent, sous le statut HTTP 400. Le code seul couvre des cas aussi différents qu'un mauvais type de média et un mauvais destinataire de DM : lisez donc error_subcode et error_user_msg avant de modifier quoi que ce soit.

Que signifie le sous-code 33 ?

Que l'ID de la requête ne mène nulle part où ce token puisse aller. Le message de Meta dit : « Unsupported get request. Object with ID does not exist, cannot be loaded due to missing permissions, or does not support this operation ». Sa correction consiste à vérifier que l'ID existe et que l'application a la permission d'y accéder. Sur un POST, les références de Meta donnent pour le sous-code 33 : « Unsupported post request ».

Qu'est-ce qui fait échouer un ID avec le sous-code 33 ?

Des vérifications à faire avant tout, chacune liée à une partie du message de Meta :

  • L'objet existe : un post supprimé ou un ID mal saisi ne laisse rien à charger.
  • Le token appartient au compte qui le possède, puisqu'une permission n'atteint que les données du compte qui l'a accordée.
  • L'ID est du bon type : un ID de conteneur issu de POST /<IG_ID>/media n'est pas l'ID du média que renvoie media_publish.
  • Le nœud prend en charge l'appel : un commentaire trouvé via les mentions se lit par le nœud de commentaire mentionné, sauf si c'est le propriétaire du commentaire qui fait la requête.
  • L'ID provient de la même connexion : les ID de messages issus d'une intégration Instagram Login ont un format différent sous Unified Login.

Quels sous-codes de publication accompagnent le code 100 ?

Six lignes du tableau d'erreurs Instagram de Meta, chacune concernant une valeur du conteneur de média. Les trois lignes de balisage produit ne concernent que les configurations avec balisage produit, que la vue d'ensemble de Meta marque comme non prise en charge sur Instagram Login :

  • 2207023 : le type de média est inconnu ; les conteneurs acceptent CAROUSEL, REELS ou STORIES comme media_type.
  • 2207028 : le carrousel a trop peu ou trop d'éléments ; le message indique encore 2 à 10, alors que le guide de publication de Meta autorise jusqu'à 20.
  • 2207040 : plus de 20 mentions @ sur le média ; en utiliser moins.
  • 2207035 : des positions de balisage produit ont été envoyées pour une vidéo, qui n'en accepte aucune.
  • 2207036 : positions de balisage produit manquantes pour une photo, qui exige des coordonnées x et y.
  • 2207037 : un balisage produit que Meta n'a pas pu ajouter ; ne balisez que les produits de la liste éligible du compte.

Quels sous-codes de messagerie accompagnent le code 100 ?

Les codes d'erreur courants de Meta pour la messagerie listent ceux-ci avec le code 100, chacun avec la modification qui le corrige :

  • 2534014 : aucun utilisateur Instagram correspondant ; envoyez vers l'ID à portée Instagram issu du webhook, car les ID utilisateur Instagram ne sont pas pris en charge.
  • 2534015 : données de message invalides ; le contenu n'est pas autorisé pour ce type de message.
  • 2534025 : le commentaire est invalide pour une réponse privée.
  • 2534037 : l'application n'est pas propriétaire du fil, car une autre application, Meta Business AI comprise, détient la conversation.
  • 2534029 : l'entreprise est bloquée et ne peut plus envoyer de messages via l'API tant que les violations de politique ne sont pas résolues.

Quels sous-codes audio accompagnent le code 100 ?

Onze lignes concernent /ig_audio, la recherche de l'API Audio, qui fonctionne avec Facebook Login et Unified Login. La plupart concernent son parcours publicitaire de remplacement de musique protégée dans un Reel : user_id et ig_user_id envoyés ensemble (9050), un purpose absent ou invalide pour product=ADS (9052), un audio_replacement_mode absent ou invalide (9056, 9057), un search_query absent ou non autorisé (9058, 9060), un ig_media_id absent, qui n'est pas un Reel ou qui ne contient pas de musique protégée (9054, 9062, 9055), et des problèmes de partnership_ad_code (9063, 9064).

En quoi un média introuvable diffère-t-il de l'erreur 100 ?

La publication signale les médias manquants sous d'autres codes. Le tableau de Meta donne le code 24, sous-code 2207006, lorsque le média est introuvable, avec une permission manquante ou un token expiré possibles, à corriger par un nouveau conteneur ; le code 24, sous-code 2207008, lorsqu'un conteneur n'existe pas ou a expiré, à réessayer une ou deux fois dans un délai de 30 secondes à 2 minutes ; et le code -2, sous-code 2207020, lorsque le média a expiré. L'erreur 100 avec le sous-code 33 est le cas général : un ID que le token ne peut pas atteindre.

Pourquoi un appel fonctionne-t-il avec une connexion et échoue-t-il avec une autre ?

Parce que les trois configurations diffèrent par l'hôte, le token et les fonctionnalités. Les appels Instagram Login vont vers graph.instagram.com avec un token d'accès Instagram User et les permissions instagram_business_*, tandis que Facebook Login et Unified Login utilisent leur propre hôte Graph, leurs propres tokens et les permissions instagram_*. La vue d'ensemble de Meta marque la recherche de hashtags, le balisage produit et les publicités partenaires comme non pris en charge sur Instagram Login, et l'API Audio ne fonctionne que sur les deux autres configurations. Avec Unified Login, /me ne renvoie pas le compte Instagram : les appels utilisent donc l'ID issu de GET /me/assigned_instagram_accounts.

Comment corriger l'erreur 100 ?

Modifiez la requête en suivant le sous-code, car la renvoyer à l'identique donne la même réponse. Pour le sous-code 33, relisez l'ID avec un GET utilisant le même token et confirmez qu'il s'agit de l'ID du média publié, et non d'un ID de conteneur. Pour les sous-codes de publication, corrigez la valeur que désigne le message. Pour la messagerie, répondez à l'ID à portée Instagram issu du webhook. Conservez aussi le fbtrace_id dans le journal : c'est l'identifiant de support de Meta pour la requête.

Erreurs courantes

  • Relancer le sous-code 33 à l'identique. L'ID ou sa permission est erroné, et Meta répond de la même façon tant que la requête ne change pas.
  • Envoyer un DM à l'ID utilisateur Instagram d'une personne. La messagerie prend l'ID à portée Instagram issu du webhook de messages, et Meta répond à un ID utilisateur par le sous-code 2534014.
  • Utiliser l'ID de conteneur après la publication. Les commentaires, les insights et les lectures ultérieures se font sur l'ID du média que renvoie media_publish, et non sur le conteneur.
Faire cela avec EasyCoexistence

list_social_accounts et list_social_posts fournissent les IDs de compte et de média dont ces appels ont besoin. 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

Faut-il réessayer l'erreur 100 de l'API Instagram ?

Pas à l'identique. Elle concerne la requête elle-même, un ID, une valeur ou un paramètre, donc la même requête renvoie la même erreur tant que cette partie n'est pas corrigée.

Pourquoi Instagram indique-t-il qu'un objet n'existe pas alors que la publication est en ligne ?

Vérifiez quel ID a été envoyé et avec quel token. Le sous-code 33 couvre aussi un objet que le token ne peut pas charger faute de permission, comme un média d'un autre compte.

Que signifie l'erreur 100 avec le sous-code 2207023 ?

Le media_type envoyé n'est pas reconnu par Instagram. Les conteneurs acceptent CAROUSEL, REELS ou STORIES, ou aucun media_type pour une seule image ; Meta a cessé de prendre en charge VIDEO le 9 novembre 2023.

L'erreur 100 signifie-t-elle que mon compte Instagram est restreint ?

Non. Un compte restreint apparaît sous le code 25, sous-code 2207050 ; l'erreur 100 concerne une valeur de la requête.

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