Instagram API Error ReferenceVollständiger Leitfaden zur Fehlerbehebung mit Lösungen

Umfassende Referenz für Instagram Graph API-Fehler. Beheben Sie Probleme beim Medien-Upload, Business-Konto-Probleme, Karussell-Probleme und Produkt-Tagging-Fehler.

32Fehlercodes
8Kategorien
Graph API v19.0

Fehlerkategorien

Authentifizierung

5 errors

Medien-Upload

8 errors

Medienformat

8 errors

Inhalt

3 errors

Karussell

1 error

Produkt-Tagging

4 errors

Ratenlimit

2 errors

Server

1 error

Alle Fehlercodes

#Authentifizierung

REVOKED_ACCESS_TOKENrefresh-token

Instagram-Zugriffstoken wurde widerrufen. Bitte verbinden Sie Ihr Instagram-Konto erneut.

Lösung:

Ihr Instagram-Zugriffstoken wurde widerrufen. Dies geschieht, wenn Sie App-Berechtigungen in Ihren Instagram-Einstellungen entfernen. Gehen Sie zu Ihren Kontoeinstellungen und verbinden Sie Instagram mit allen erforderlichen Berechtigungen erneut.

session has been invalidatedrefresh-token

Ihre Instagram-Sitzung ist abgelaufen. Bitte verbinden Sie Ihr Instagram-Konto erneut.

Lösung:

Ihre Instagram-Sitzung ist nicht mehr gültig. Dies kann nach einer Passwortänderung oder Sicherheitsprüfung geschehen. Verbinden Sie Ihr Instagram-Konto erneut, um eine neue Sitzung zu erstellen.

the user is not an instagram businessrefresh-token

Ihr Instagram-Konto muss ein Business-Konto sein. Bitte konvertieren Sie es in ein Business-Konto und verbinden Sie es erneut.

Lösung:

Die Instagram-API benötigt ein Business- oder Creator-Konto. Konvertieren Sie Ihr Konto: Gehen Sie zu Instagram-Einstellungen → Konto → Zu professionellem Konto wechseln → Business wählen.

2207050user-error

Ihr Instagram-Konto wurde eingeschränkt. Bitte überprüfen Sie Ihren Kontostatus auf Instagram.

Lösung:

Instagram hat Ihr Konto eingeschränkt. Melden Sie sich direkt bei Instagram an, um zu sehen, ob es Warnungen oder Einschränkungen gibt. Möglicherweise müssen Sie Ihre Identität verifizieren oder gegen die Einschränkung Einspruch einlegen.

Not enough permissions to postuser-error

Nicht genügend Berechtigungen zum Posten.

Lösung:

Die App hat nicht die erforderlichen Berechtigungen. Stellen Sie bei der erneuten Verbindung sicher, dass Sie alle Berechtigungen erteilen, insbesondere 'instagram_content_publish' und 'instagram_basic'.

#Medien-Upload

2207003user-error

Zeitüberschreitung beim Herunterladen von Medien, bitte versuchen Sie es erneut.

Lösung:

Instagram konnte Ihre Medien nicht innerhalb der Zeitüberschreitungsperiode von der URL herunterladen. Stellen Sie sicher, dass Ihre Medien-URL öffentlich zugänglich ist und der Server schnell antwortet. Versuchen Sie, erneut hochzuladen.

2207020user-error

Medien abgelaufen, bitte laden Sie erneut hoch.

Lösung:

Der Mediencontainer ist vor der Veröffentlichung abgelaufen. Instagram-Mediencontainer laufen nach 24 Stunden ab. Erstellen Sie einen neuen Mediencontainer und veröffentlichen Sie ihn sofort.

2207032user-error

Medien konnten nicht erstellt werden, bitte versuchen Sie es erneut.

Lösung:

Instagram konnte den Mediencontainer nicht erstellen. Dies könnte ein vorübergehendes Problem sein. Warten Sie einen Moment und versuchen Sie es erneut. Stellen Sie sicher, dass Ihre Medien den Instagram-Spezifikationen entsprechen.

2207053user-error

Unbekannter Upload-Fehler, bitte versuchen Sie es erneut.

Lösung:

Ein unbekannter Fehler ist beim Hochladen aufgetreten. Überprüfen Sie, ob Ihre Mediendatei gültig ist und den Instagram-Anforderungen entspricht. Versuchen Sie, eine andere Datei hochzuladen, um das Problem zu isolieren.

2207052user-error

Medienabruf fehlgeschlagen, bitte versuchen Sie es erneut.

Lösung:

Instagram konnte Ihre Medien von der angegebenen URL nicht abrufen. Überprüfen Sie, ob die URL öffentlich zugänglich ist, den richtigen Content-Type-Header zurückgibt und die Datei gültig ist.

2207006user-error

Medien nicht gefunden, bitte laden Sie erneut hoch.

Lösung:

Der Mediencontainer wurde nicht gefunden. Er wurde möglicherweise gelöscht oder ist abgelaufen. Erstellen Sie einen neuen Mediencontainer und versuchen Sie es erneut.

2207008user-error

Medien-Builder abgelaufen, bitte versuchen Sie es erneut.

Lösung:

Die Medien-Builder-Sitzung ist abgelaufen. Dies geschieht, wenn zu viel Zeit zwischen dem Erstellen des Containers und der Veröffentlichung vergeht. Erstellen und veröffentlichen Sie in einem Durchgang.

2207027user-error

Unbekannter Fehler, bitte versuchen Sie es später erneut oder kontaktieren Sie den Support.

Lösung:

Ein unbekannter Fehler ist aufgetreten. Warten Sie einige Minuten und versuchen Sie es erneut. Wenn das Problem weiterhin besteht, kontaktieren Sie den Support mit allen Fehlerdetails.

#Medienformat

2207004user-error

Das Bild ist zu groß.

Lösung:

Reduzieren Sie Ihre Bilddateigröße. Instagram hat eine maximale Dateigröße von 8 MB für Bilder. Verwenden Sie ein Bildkomprimierungstool, um die Dateigröße bei gleichbleibender Qualität zu reduzieren.

2207005user-error

Nicht unterstütztes Bildformat.

Lösung:

Instagram unterstützt nur die Bildformate JPG und PNG. Konvertieren Sie Ihr Bild in eines dieser Formate, bevor Sie es hochladen.

2207009user-error

Seitenverhältnis nicht unterstützt (muss zwischen 4:5 und 1.91:1 liegen).

Lösung:

Instagram erfordert Seitenverhältnisse zwischen 4:5 (Hochformat) und 1.91:1 (Querformat). Schneiden Sie Ihr Bild zu oder ändern Sie die Größe, um diese Grenzen einzuhalten.

36003user-error

Seitenverhältnis nicht unterstützt (muss zwischen 4:5 und 1.91:1 liegen).

Lösung:

Das Seitenverhältnis Ihres Bildes liegt außerhalb des von Instagram zugelassenen Bereichs. Verwenden Sie 1:1 (quadratisch), 4:5 (Hochformat) oder 1.91:1 (Querformat). Vermeiden Sie extreme Seitenverhältnisse.

36001user-error

Ungültige Instagram-Bildauflösung max: 1920x1080px.

Lösung:

Instagram begrenzt die Bildauflösung auf 1920x1080 Pixel. Ändern Sie die Größe Ihres Bildes, um diese Abmessungen einzuhalten.

2207026user-error

Nicht unterstütztes Videoformat.

Lösung:

Instagram unterstützt nur das MP4-Videoformat mit H.264-Codec und AAC-Audio. Konvertieren Sie Ihr Video, um diese Spezifikationen zu erfüllen.

2207057user-error

Ungültiger Thumbnail-Offset für Video.

Lösung:

Der von Ihnen angegebene Thumbnail-Offset ist ungültig. Er muss innerhalb der Videodauer liegen. Verwenden Sie einen Wert zwischen 0 und der Videolänge in Millisekunden.

2207023user-error

Unbekannter Medientyp.

Lösung:

Instagram konnte Ihren Medientyp nicht bestimmen. Stellen Sie sicher, dass Sie den richtigen media_type-Parameter angeben (IMAGE, VIDEO oder CAROUSEL_ALBUM).

#Inhalt

2207010user-error

Die Bildunterschrift ist zu lang.

Lösung:

Instagram-Bildunterschriften haben eine maximale Länge von 2.200 Zeichen. Kürzen Sie Ihre Bildunterschrift und versuchen Sie es erneut.

2207001user-error

Instagram hat erkannt, dass Ihr Beitrag Spam ist. Versuchen Sie, den Inhalt zu ändern.

Lösung:

Die Spam-Erkennung von Instagram hat Ihren Inhalt markiert. Vermeiden Sie sich wiederholende Beiträge, übermäßige Hashtags oder Spam-Sprache. Warten Sie eine Weile und versuchen Sie, anderen Inhalt zu posten.

2207051user-error

Instagram hat Ihre Anfrage blockiert.

Lösung:

Instagram hat diese Anfrage blockiert, wahrscheinlich aufgrund von Ratenlimit oder verdächtiger Aktivität. Warten Sie 15-30 Minuten, bevor Sie es erneut versuchen, und reduzieren Sie die Posting-Frequenz.

#Produkt-Tagging

2207035user-error

Produkt-Tag-Positionen werden für Videos nicht unterstützt.

Lösung:

Sie können keine Produkt-Tag-Positionen für Video-Posts angeben. Nur Bild-Posts unterstützen positionierte Produkt-Tags.

2207036user-error

Produkt-Tag-Positionen erforderlich für Fotos.

Lösung:

Beim Taggen von Produkten in Fotos müssen Sie x- und y-Koordinaten für Tag-Positionen angeben. Geben Sie Positionsdaten für alle Produkt-Tags an.

2207037user-error

Produkt-Tag-Validierung fehlgeschlagen.

Lösung:

Ein oder mehrere Produkt-Tags sind ungültig. Überprüfen Sie, ob alle Produkt-IDs in Ihrem Katalog vorhanden sind und die Positionskoordinaten zwischen 0,0 und 1,0 liegen.

2207040user-error

Zu viele Produkt-Tags.

Lösung:

Instagram begrenzt die Anzahl der Produkt-Tags pro Post. Reduzieren Sie die Anzahl der Produkte, die Sie taggen (das Maximum beträgt normalerweise 5 Produkte pro Bild).

#Ratenlimit

Page request limit reacheduser-error

Das Posten von Seiten für heute ist begrenzt, bitte versuchen Sie es morgen erneut.

Lösung:

Sie haben das tägliche Posting-Limit von Instagram erreicht. Instagram erlaubt 25 Posts pro Tag. Warten Sie bis zum nächsten Tag, um mehr Inhalte zu posten.

2207042user-error

Sie haben das Maximum von 25 Posts pro Tag erreicht, die für Ihr Konto zulässig sind.

Lösung:

Instagram setzt ein Limit von 25 Posts pro Tag durch. Warten Sie bis morgen, um mehr Inhalte zu posten. Erwägen Sie, Ihre Posts zu planen, um sie auf mehrere Tage zu verteilen.

#Server

An unknown error occurredretry

Instagram ist auf einen unbekannten Fehler gestoßen, versuche es erneut...

Lösung:

Instagram ist auf einen vorübergehenden Fehler gestoßen. Das System wird automatisch wiederholen. Wenn es weiterhin fehlschlägt, warten Sie einige Minuten, bevor Sie es erneut versuchen.

Beste Praktiken

Fehlerbehandlung

  • Implementieren Sie automatische Wiederholungen für Medienverarbeitung und Servicefehler
  • Verwalten Sie Ablauf von Mediencontainern (24-Stunden-Limit)
  • Validieren Sie Medienspezifikationen vor dem Upload
  • Überwachen Sie Instagram-Kontogesundheit und Einschränkungen

Präventions-Tipps

  • Stellen Sie vor der Verbindung ein Business- oder Creator-Konto sicher
  • Validieren Sie Medienformat, Größe und Seitenverhältnis
  • Erstellen und veröffentlichen Sie Mediencontainer innerhalb von 24 Stunden
  • Respektieren Sie das Limit von 25 Beiträgen pro Tag

Benötigen Sie Hilfe bei der Instagram Integration?

Unsere API behandelt Fehlerszenarien automatisch mit intelligenter Wiederholungslogik und detaillierter Protokollierung.