Instagram API Error ReferenceGuide complet de dépannage avec solutions

Référence complète pour les erreurs de l'API Instagram Graph. Trouvez des solutions pour les téléchargements de médias, les problèmes de compte professionnel, les carrousels et le marquage de produits.

32codes d'erreur
8catégories
Graph API v19.0

Catégories d'Erreurs

Authentification

5 errors

Téléchargement de médias

8 errors

Format de médias

8 errors

Contenu

3 errors

Carrousel

1 error

Marquage de produits

4 errors

Limitation de débit

2 errors

Serveur

1 error

Tous les Codes d'Erreur

#Authentification

REVOKED_ACCESS_TOKENrefresh-token

Le jeton d'accès Instagram a été révoqué. Veuillez reconnecter votre compte Instagram.

Solution :

Votre jeton d'accès Instagram a été révoqué. Cela se produit lorsque vous supprimez les autorisations de l'application dans vos paramètres Instagram. Allez dans les paramètres de votre compte et reconnectez Instagram avec toutes les autorisations requises.

session has been invalidatedrefresh-token

Votre session Instagram a expiré. Veuillez reconnecter votre compte Instagram.

Solution :

Votre session Instagram n'est plus valide. Cela peut se produire après un changement de mot de passe ou une vérification de sécurité. Reconnectez votre compte Instagram pour établir une nouvelle session.

the user is not an instagram businessrefresh-token

Votre compte Instagram doit être un compte professionnel. Veuillez le convertir en compte professionnel et reconnecter.

Solution :

L'API Instagram nécessite un compte professionnel ou créateur. Convertissez votre compte : Allez dans Paramètres Instagram → Compte → Passer au compte professionnel → Choisir Professionnel.

2207050user-error

Votre compte Instagram a été restreint. Veuillez vérifier l'état de votre compte sur Instagram.

Solution :

Instagram a restreint votre compte. Connectez-vous directement à Instagram pour voir s'il y a des avertissements ou restrictions. Vous devrez peut-être vérifier votre identité ou faire appel de la restriction.

Not enough permissions to postuser-error

Autorisations insuffisantes pour publier.

Solution :

L'application n'a pas les autorisations requises. Lors de la reconnexion, assurez-vous d'accorder toutes les autorisations, en particulier 'instagram_content_publish' et 'instagram_basic'.

#Téléchargement de médias

2207003user-error

Délai de téléchargement des médias dépassé, veuillez réessayer.

Solution :

Instagram n'a pas pu télécharger vos médias depuis l'URL dans le délai imparti. Assurez-vous que votre URL de média est accessible publiquement et que le serveur répond rapidement. Essayez de re-télécharger.

2207020user-error

Média expiré, veuillez télécharger à nouveau.

Solution :

Le conteneur de médias a expiré avant la publication. Les conteneurs de médias Instagram expirent après 24 heures. Créez un nouveau conteneur de médias et publiez-le immédiatement.

2207032user-error

Échec de la création du média, veuillez réessayer.

Solution :

Instagram n'a pas réussi à créer le conteneur de médias. Cela pourrait être un problème temporaire. Attendez un instant et réessayez. Assurez-vous que vos médias répondent aux spécifications d'Instagram.

2207053user-error

Erreur de téléchargement inconnue, veuillez réessayer.

Solution :

Une erreur inconnue s'est produite lors du téléchargement. Vérifiez que votre fichier média est valide et répond aux exigences d'Instagram. Essayez de télécharger un fichier différent pour isoler le problème.

2207052user-error

Échec de récupération du média, veuillez réessayer.

Solution :

Instagram n'a pas pu récupérer vos médias depuis l'URL fournie. Vérifiez que l'URL est accessible publiquement, renvoie le bon en-tête content-type et que le fichier est valide.

2207006user-error

Média introuvable, veuillez télécharger à nouveau.

Solution :

Le conteneur de médias n'a pas été trouvé. Il a peut-être été supprimé ou a expiré. Créez un nouveau conteneur de médias et réessayez.

2207008user-error

Le constructeur de médias a expiré, veuillez réessayer.

Solution :

La session du constructeur de médias a expiré. Cela se produit si trop de temps s'est écoulé entre la création du conteneur et la publication. Créez et publiez en un seul flux.

2207027user-error

Erreur inconnue, veuillez réessayer plus tard ou contacter le support.

Solution :

Une erreur inconnue s'est produite. Attendez quelques minutes et réessayez. Si le problème persiste, contactez le support avec tous les détails de l'erreur.

#Format de médias

2207004user-error

L'image est trop volumineuse.

Solution :

Réduisez la taille de votre fichier image. Instagram a une taille de fichier maximale de 8 Mo pour les images. Utilisez un outil de compression d'image pour réduire la taille du fichier tout en maintenant la qualité.

2207005user-error

Format d'image non pris en charge.

Solution :

Instagram ne prend en charge que les formats d'image JPG et PNG. Convertissez votre image dans l'un de ces formats avant de la télécharger.

2207009user-error

Rapport d'aspect non pris en charge (doit être entre 4:5 et 1.91:1).

Solution :

Instagram nécessite des rapports d'aspect entre 4:5 (portrait) et 1.91:1 (paysage). Recadrez ou redimensionnez votre image pour respecter ces limites.

36003user-error

Rapport d'aspect non pris en charge (doit être entre 4:5 et 1.91:1).

Solution :

Le rapport d'aspect de votre image est en dehors de la plage autorisée par Instagram. Utilisez 1:1 (carré), 4:5 (portrait) ou 1.91:1 (paysage). Évitez les rapports d'aspect extrêmes.

36001user-error

Résolution d'image Instagram invalide max : 1920x1080px.

Solution :

Instagram limite la résolution d'image à 1920x1080 pixels. Redimensionnez votre image pour respecter ces dimensions.

2207026user-error

Format vidéo non pris en charge.

Solution :

Instagram ne prend en charge que le format vidéo MP4 avec codec H.264 et audio AAC. Convertissez votre vidéo pour répondre à ces spécifications.

2207057user-error

Décalage de miniature invalide pour la vidéo.

Solution :

Le décalage de miniature que vous avez spécifié est invalide. Il doit être dans la durée de la vidéo. Utilisez une valeur entre 0 et la longueur de la vidéo en millisecondes.

2207023user-error

Type de média inconnu.

Solution :

Instagram n'a pas pu déterminer votre type de média. Assurez-vous de spécifier le bon paramètre media_type (IMAGE, VIDEO ou CAROUSEL_ALBUM).

#Contenu

2207010user-error

La légende est trop longue.

Solution :

Les légendes Instagram ont une longueur maximale de 2 200 caractères. Raccourcissez votre légende et réessayez.

2207001user-error

Instagram a détecté que votre publication est du spam. Essayez de modifier le contenu.

Solution :

La détection de spam d'Instagram a signalé votre contenu. Évitez les publications répétitives, les hashtags excessifs ou le langage spam. Attendez un moment et essayez de publier un contenu différent.

2207051user-error

Instagram a bloqué votre demande.

Solution :

Instagram a bloqué cette demande, probablement en raison de la limitation de débit ou d'une activité suspecte. Attendez 15-30 minutes avant de réessayer et réduisez la fréquence de publication.

#Marquage de produits

2207035user-error

Les positions de balises de produits ne sont pas prises en charge pour les vidéos.

Solution :

Vous ne pouvez pas spécifier de positions de balises de produits pour les publications vidéo. Seules les publications d'images prennent en charge les balises de produits positionnées.

2207036user-error

Positions de balises de produits requises pour les photos.

Solution :

Lors du balisage de produits dans les photos, vous devez spécifier les coordonnées x et y pour les positions de balises. Fournissez des données de position pour toutes les balises de produits.

2207037user-error

Échec de validation de la balise de produit.

Solution :

Une ou plusieurs balises de produits sont invalides. Vérifiez que tous les ID de produits existent dans votre catalogue et que les coordonnées de position sont entre 0.0 et 1.0.

2207040user-error

Trop de balises de produits.

Solution :

Instagram limite le nombre de balises de produits par publication. Réduisez le nombre de produits que vous balisez (le maximum est généralement de 5 produits par image).

#Limitation de débit

Page request limit reacheduser-error

La publication de pages pour aujourd'hui est limitée, veuillez réessayer demain.

Solution :

Vous avez atteint la limite de publication quotidienne d'Instagram. Instagram autorise 25 publications par jour. Attendez le lendemain pour publier plus de contenu.

2207042user-error

Vous avez atteint le maximum de 25 publications par jour autorisées pour votre compte.

Solution :

Instagram applique une limite de 25 publications par jour. Attendez demain pour publier plus de contenu. Envisagez de planifier vos publications pour les répartir sur plusieurs jours.

#Serveur

An unknown error occurredretry

Instagram a rencontré une erreur inconnue, nouvelle tentative...

Solution :

Instagram a rencontré une erreur temporaire. Le système va automatiquement réessayer. Si cela continue à échouer, attendez quelques minutes avant de réessayer.

Meilleures Pratiques

Gestion des Erreurs

  • Implémenter des nouvelles tentatives automatiques pour le traitement des médias et les erreurs de service
  • Gérer l'expiration des conteneurs multimédias (limite de 24 heures)
  • Valider les spécifications des médias avant le téléchargement
  • Surveiller l'état et les restrictions du compte Instagram

Conseils de Prévention

  • Assurer un compte Business ou Creator avant de connecter
  • Valider le format, la taille et le rapport d'aspect des médias
  • Créer et publier des conteneurs multimédias dans les 24 heures
  • Respecter la limite de 25 publications par jour

Besoin d'Aide pour Instagram l'Intégration?

Notre API gère automatiquement les scénarios d'erreur avec une logique de nouvelle tentative intelligente et une journalisation détaillée.