Codes d’erreur

Ce document décrit les messages d’erreur pouvant être renvoyés par l’API Instagram. La réponse présentée ci-dessous montre un exemple de code 3600 et de sous-code 2207004 pour lesquels les codes d’erreur suivants sont définis.

Exemple de réponse

{
  "error": 
    {
      "message": "The image size is too large.",
      "type": "OAuthException",
      "code": 36000,
      "error_subcode": 2207004,
      "is_transient": false,
      "error_user_title": "Image size too large",
      "error_user_msg": "The image is too large to download. It should be less than 8 MiB.",
      "fbtrace_id": "A6LJylpZRKw2xKLFsAP-cJh"
   }
 }

Codes d’erreur définis

Code de statut HTTP	Code	Sous-code	Message présenté à l’utilisateur·trice	Solution recommandée
`400`	`-2`	`2207003`	`It takes too long to download the media.`	Le délai a expiré lors du téléchargement du contenu multimédia. Retentez l’opération.
`400`	`-2`	`2207020`	`The media you are trying to access has expired. Please try to upload again.`	Générez un nouvel ID de conteneur et utilisez-le pour réessayer.
`400`	`-1`	`2207001`		Erreur du serveur Instagram. Réessayez.
`400`	`-1`	`2207032`	`Create media fail, please try to re-create media`	Impossible de créer un conteneur de contenu multimédia. Réessayez.
`400`	`-1`	`2207053`	`unknown upload error`	Une erreur inconnue s’est produite lors de l’importation. Générez un nouveau conteneur et utilisez-le pour réessayer. Cela ne devrait affecter que l’importation de vidéos.
`400`	`1`	`2207057`	`Thumbnail offset must be greater than or equal to 0 and less than video duration, i.e.` {video-length}	Le décalage de miniature que vous avez entré sort du champ de durée de la vidéo. Ajoutez le décalage correct en millisecondes.
`400`	`4`	`2207051`	`We restrict certain activity to protect our community. Tell us if you think we made a mistake.`	L’action de publication semble être du spam. Nous restreignons certaines activités afin de protéger notre communauté. Si vous êtes en mesure de déterminer que l’action de publication n’est pas du spam, faites-le-nous savoir.
`400`	`9`	`2207042`	`You reached maximum number of posts that is allowed to be published by Content Publishing API.`	L’utilisateur·trice de l’application a atteint sa limite de publication quotidienne. Conseillez à l’utilisateur·trice de réessayer le lendemain.
`400`	`24`	`2207006`	`The media with` {media-id} `cannot be found`	Possible erreur d’autorisation due à une autorisation manquante ou à l’expiration d’un token. Générez un nouveau conteneur et utilisez-le pour réessayer.
`400`	`24`	`2207008`	`The media builder with creation id =` {creation-id} `does not exist or has been expired.`	Erreur temporaire lors de la publication d’un conteneur. Réessayez une ou deux fois dans les 30 prochaines secondes à 2 minutes. En cas d’échec, générez un nouvel ID de conteneur et utilisez-le pour réessayer.
`400`	`25`	`2207050`	`The Instagram account is restricted.`	Le compte Instagram professionnel de l’utilisateur·trice de l’application est inactif, soumis à un point de contrôle ou restreint. Conseillez à l’utilisateur·trice de l’application de se connecter à l’application Instagram et d’exécuter toutes les actions requises par l’application pour réactiver son compte.
`400`	`100`	`2207023`	`The media type` {media-type} `is unknown.`	Le type de contenu multimédia entré ne correspond à aucun type de contenu multimédia attendu. Veuillez entrer un type correct.
`400`	`100`	`2207028`	`Your post won't work as a carousel. Carousels need at least 2 photos/videos and no more than 10 photos/videos.`	Réessayez en utilisant un nombre de photos et de vidéos acceptable.
`400`	`100`	`2207035`	`Product tag positions should not be specified for video media.`	Les coordonnées X/Y ne sont pas prises en charge dans les vidéos. Désactivez-les avec les vidéos.
`400`	`100`	`2207036`	`Product tag positions are required for photo media.`	Dans les images, les tags de produit doivent inclure des coordonnées X/Y. Elles sont obligatoires.
`400`	`100`	`2207037`	`We couldn't add all of your product tags. The product ID may be incorrect, the product may be deleted, or you may not have permission to tag the product.`	Un ou plusieurs des produits utilisés pour identifier l’élément ne sont pas valides (supprimés, rejetés, autorisation manquante pour l’utilisateur·trice de l’application, ID de produit non valide, etc.). Obtenez à nouveau les catalogues et les produits éligibles des utilisateurs·trices de l’application, puis autorisez-les à utiliser uniquement ces ID de produit au moment d’ajouter un tag.
`400`	`100`	`2207040`	`Cannot use more than` {max-tag-count} `tags per created media.`	L’utilisateur a dépassé le nombre maximal de (20) tags @. Conseillez à l’utilisateur·trice d’utiliser moins de tags @.
`400`	`352`	`2207026`	`The video format is not supported. Please check spec for supported` {video} `format`	Format vidéo non pris en charge. Conseillez à l’utilisateur·trice d’importer un fichier MOV ou MP4 (MPEG-4 Part 14). Voir les Spécifications vidéo.
`400`	`9004`	`2207052`	`The media could not be fetched from this uri:` {uri}	Le contenu multimédia n’a pas pu être récupéré à partir de l’URI fourni. Conseillez à l’utilisateur·trice de l’application de vérifier que l’URI est valide et disponible publiquement.
`400`	`9007`	`2207027`	`The media is not ready for publishing, please wait for a moment`	Vérifiez le statut du conteneur et procédez à la publication lorsque son statut est `FINISHED`.
`400`	`36000`	`2207004`	`The image is too large to download. It should be less than` {size}`.`	L’image dépasse la taille de fichier maximale de 8 Mio. Conseillez à l’utilisateur·trice de réessayer en utilisant une image moins volumineuse.
`400`	`36001`	`2207005`	`The image format` {current-image-format} `is not supported. Supported formats are:` {format}`.`	Possible erreur d’autorisation due à une autorisation manquante ou à l’expiration d’un token. Générez un nouveau conteneur et utilisez-le pour réessayer.
`400`	`36003`	`2207009`	`The submitted image with aspect ratio` {submitted-ratio} `cannot be published. Please submit an image with a valid aspect ratio.`	Le format de l’image se situe hors de la plage acceptable. Conseillez à l’utilisateur·trice de l’application de réessayer avec une image se situant dans la plage de 4:5 à 1.91:1.
`400`	`36004`	`2207010`	`The submitted image's caption was` {submitted-caption-length} `characters long. The maximum number of characters permitted for a caption is` {maximum-caption-length}. `Please submit media with a shorter caption.`	L’utilisateur·trice a dépassé le nombre maximal de caractères autorisé pour un sous-titre. Conseillez à l’utilisateur·trice d’utiliser un sous-titre plus court. Maximum 2 200 caractères, 30 hashtags et 20 tags @.
`400`	`100`	`9050`	`Provide either user_id or ig_user_id, not both.`	`/ig_audio` a reçu à la fois `user_id` et `ig_user_id`. Envoyez-en un seul ; privilégiez `ig_user_id`.
`400`	`100`	`9052`	`Missing or invalid purpose for product=ADS.`	Définissez `purpose=AUDIO_COPYRIGHT_REPLACEMENT`. Il s’agit actuellement du seul sous-cas d’utilisation pris en charge pour `product=ADS`.
`400`	`100`	`9056`	`Missing required parameter audio_replacement_mode.`	Envoyez `audio_replacement_mode` comme `auto`, `search` ou `default`.
`400`	`100`	`9057`	`Invalid audio_replacement_mode value.`	Utilisez `auto`, `search` ou `default` (non sensible à la casse).
`400`	`100`	`9058`	`Missing required parameter search_query.`	`search_query` est requis lorsque `audio_replacement_mode=search`. Ajoutez un terme de recherche.
`400`	`100`	`9060`	`The search_query parameter is only valid when audio_replacement_mode=search.`	Abandonnez `search_query` dans les modes `auto`/`default`, ou définissez `audio_replacement_mode=search`.
`400`	`100`	`9054`	`The ig_media_id parameter is required.`	Fournissez l’ID Facebook (`/me/media`) du contenu multimédia Instagram du reel contenant la musique à remplacer.
`400`	`100`	`9062`	`The supplied ig_media_id refers to a non-Reel media.`	La découverte des swaps audio ne prend en charge que les reels. Indiquez l’ID Facebook d’un reel.
`400`	`100`	`9055`	`This media does not contain copyrighted licensed music.`	La découverte des swaps audio est uniquement disponible pour les reels contenant de la musique protégée par des droits d’auteur. Choisissez un reel présentant un problème de droit d’auteur.
`400`	`100`	`9063`	`The supplied partnership_ad_code is invalid or expired.`	Générez un code de co-publicité valide et réessayez.
`400`	`100`	`9064`	`The supplied partnership_ad_code does not match the ig_media_id.`	Utilisez un `partnership_ad_code` généré pour le même contenu multimédia que `ig_media_id`.
`403`	`200`		`The calling app is missing the ads_management permission for the target.`	Demandez et obtenez l’autorisation `ads_management` pour l’utilisateur·ice cible, puis réessayez.
`403`	`10`	`9053`	`Ads audio swap discovery is not yet available.`	Cette fonctionnalité fait l’objet d’un déploiement limité. L’accès est limité. Contactez votre partenaire Meta.