Zum Hauptinhalt springen
Die REST-API enthält in der Antwort gegebenenfalls eine Liste von Fehlern.
Fehler haben einen zurückgegebenen Statuscode von 400, 401, 402, 403, 404, 429, 500, 502, 503 oder 504. Erfolg hat einen zurückgegebenen Statuscode 200. Details finden Sie hier.
Jeder API-Aufruf kann je nach spezifischer Anfrage und aufgetretenen Problemen im sozialen Netzwerk unterschiedliche Fehler zurückgeben. Die Fehlerantwort enthält Details darüber, was während des API-Aufrufs schiefgelaufen ist. Beispielsweise würde ein Beitrag, der von Twitter und Facebook als Duplikat betrachtet wird, die folgende Antwort zurückgeben.
Bitte beachten Sie:
  • Das Feld errors enthält das Array der Fehler, einen pro sozialem Netzwerk, in dem ein Fehler aufgetreten ist.
  • action bezieht sich auf die Art des zurückgegebenen Fehlers.
  • Das übergeordnete Feld status ist „error”, wenn der API-Aufruf fehlgeschlagen ist. Bei einem /post-Aufruf beispielsweise ist das Feld status „success”, wenn alle Veröffentlichungen in sozialen Netzwerken erfolgreich waren, andernfalls ist das Feld status „error”.
  • Das Feld code enthält den Ayrshare-Referenzfehlercode.
  • Das Feld message enthält die spezifischen Details zum Fehler.

Fehlerbehandlung

Sie sollten alle Fehlerantworten behandeln und die entsprechenden Maßnahmen ergreifen. Ein Fehler ist aufgetreten, wenn:
  • Der Antwort-Rückgabecode nicht 200 ist
  • Der JSON-Antwortstatus error ist
Wenn beispielsweise die Facebook-Verknüpfung von Ihrem Nutzer entfernt wurde – der Nutzer hat sein Passwort geändert oder Ayrshares Zugriff entfernt – würde beim Posten die folgende Antwort mit einem Antwortcode 400 Bad Request ausgegeben.
Eine mögliche Maßnahme wäre, Ihren Nutzer über Ihr Dashboard, per SMS oder E-Mail zu benachrichtigen. Ein weiteres Beispiel ist, wenn das veröffentlichte Instagram-Bild falsche Abmessungen oder ein falsches Seitenverhältnis hat, mit einem Antwortcode 400 Bad Request:
Eine mögliche Maßnahme wäre, die Bilder mit dem korrekten Seitenverhältnis erneut zu senden.

Instagram-spezifische Fehlercodes

Die folgenden Fehlercodes liefern spezifische Details zu Instagram-Veröffentlichungsfehlern und ersetzen nach Möglichkeit den generischen Fehler 138. Code 435 – Instagram-Ratenlimit (HTTP 429) Professionelle Instagram-Konten (Business / Creator) unterliegen einem rollierenden 24-Stunden-Limit von 50 Beiträgen über Metas Content Publishing API (private Konten können überhaupt nicht über die API veröffentlichen und erreichen dieses Limit daher nie). Wenn die Obergrenze überschritten wird, gibt Meta einen Ratenlimit-Fehler zurück. Ayrshare gibt auch code: 435 zurück, wenn Metas Publish-Endpunkt direkt HTTP 429 zurückgibt oder wenn der zugrunde liegende Fehler-Subcode (1390008) auf eine Beitrags-/Kommentar-Drosselung hinweist.
Maßnahme: Warten Sie, bis das Ratenlimit-Fenster zurückgesetzt wird, bevor Sie es erneut versuchen. Wenn Meta einen Retry-After-Header liefert, wird der Wert (in Sekunden) im Feld details weitergegeben – warten Sie mindestens so lange, bevor Sie erneut senden. Code 436 – Instagram-Zeitüberschreitung bei Medienverarbeitung (HTTP 400) Instagram hat zu lange gebraucht, um die hochgeladenen Medien zu verarbeiten. Dies kann bei großen Videodateien oder in Zeiten hoher Auslastung auf Metas Servern passieren.
Maßnahme: Wiederholen Sie den Beitrag über den retry post-Endpunkt. Wenn das Problem weiterhin besteht, versuchen Sie, die Größe der Mediendatei zu reduzieren. Code 447 – Instagram Trial Reels: fehlende graduationStrategy (HTTP 400) Wird zurückgegeben, wenn instagramOptions.trialParams bei einer /post-Anfrage angegeben ist, aber graduationStrategy fehlt, null oder ein leerer String ist. Trial Reels erfordern eine explizite Graduation-Strategie – siehe Trial Reels.
Maßnahme: Setzen Sie instagramOptions.trialParams.graduationStrategy entweder auf "MANUAL" oder "SS_PERFORMANCE" und versuchen Sie es erneut, oder entfernen Sie trialParams, wenn Sie kein Trial Reel veröffentlichen wollten. Code 448 – Instagram Trial Reels: ungültige graduationStrategy (HTTP 400) Wird zurückgegeben, wenn graduationStrategy vorhanden ist, aber nicht genau "MANUAL" oder "SS_PERFORMANCE" entspricht. Die Prüfung ist case-sensitive – Werte wie "manual" oder "ss_performance" werden abgelehnt. Das Feld details gibt den abgelehnten Eingabewert wieder (auf 64 Zeichen gekürzt), um das Debugging zu erleichtern.
Maßnahme: Senden Sie graduationStrategy genau als "MANUAL" oder "SS_PERFORMANCE" (Großbuchstaben, Typ String). Code 449 – Instagram Trial Reels: inkompatible Medien (HTTP 400) Wird zurückgegeben, wenn die Medien oder die Struktur des Beitrags nicht für ein Trial Reel geeignet sind. Trial Reels müssen ein einzelnes .mp4- oder .mov-Video sein – Karussells (mehr als eine URL), Stories (instagramOptions.stories: true) und Nicht-Video-Erweiterungen werden alle abgelehnt. Das Feld details unterscheidet, welcher Unterfall ausgelöst wurde.
Maßnahme: Senden Sie eine einzelne .mp4- oder .mov-Video-URL ohne stories: true-Flag. Entfernen Sie zusätzliche mediaUrls-Einträge oder entfernen Sie trialParams, wenn Sie einen regulären Karussell-/Story-Beitrag beabsichtigt haben. Code 258 – Instagram-Kontostatus-Fehler (HTTP 400) Ein allgemeiner Instagram-Kontostatus-Fehler mit der Basismeldung „Error with Instagram.” Dieser tritt auf, wenn Meta die Anfrage aufgrund des Zustands des verknüpften Instagram-Kontos ablehnt und nicht wegen des Inhalts des Beitrags.
Wenn der zugrunde liegende Meta-error_subcode 2207085 ist, setzt die Antwort zusätzlich relink: true und retryAvailable: true, und die Meldung fordert den Nutzer auf, das Instagram-Konto zu trennen und erneut zu verknüpfen und dabei alle Berechtigungen zu gewähren:
Maßnahme: Für den Unterfall 2207085 fordern Sie den Nutzer auf, sein Instagram-Konto in Social Accounts zu trennen und erneut zu verknüpfen und dabei alle angeforderten Berechtigungen zu gewähren, und wiederholen Sie dann den Beitrag. Bei anderen Kontostatus-Fehlern prüfen Sie, ob das Instagram-Konto bei Meta einen guten Stand hat, und versuchen Sie es erneut.

Wiederholung verfügbar

Manchmal treten in sozialen Netzwerken nicht behebbare Fehler auf, z. B. Serverprobleme, und der Aufruf schlägt letztendlich auch nach zahlreichen Wiederholungen fehl. In diesen Fällen ermittelt unser System, ob der Fehler wiederholbar ist, und wenn ja, ist das Feld retryAvailable gleich true.
Sie können den Aufruf dann mit demselben Payload erneut ausführen. Wenn es sich um einen Beitrag handelt, können Sie den retry post-Endpunkt verwenden.

X/Twitter BYO-Key-Fehler

Die folgenden Fehlercodes sind spezifisch für X/Twitter BYO-Key-Operationen (Bring Your Own): Code 272 – Verifizierung der BYO-Twitter-Identität fehlgeschlagen (HTTP 400) Ayrshare konnte Ihre X/Twitter-Identität mit Ihren BYO-Consumer-Keys und den zum Zeitpunkt der Verknüpfung gespeicherten OAuth-Tokens nicht bestätigen. Die Antwortform variiert je nach dem Aufruf, der den Fehler ausgelöst hat; beide Formen ordnen sich denselben drei Unterfällen unten zu. Prüfen Sie, welcher Fall zutrifft, indem Sie sich bei x.com mit dem Konto anmelden, dem die BYO Developer App gehört. Der Post-Pfad gibt eine minimale Antwort aus:
Der Analytics-Pfad gibt eine ausführlichere, selbstdokumentierende Meldung aus und kann ein Feld details mit der Roh-Fehlermeldung von X enthalten:
Wenn vorhanden, spiegelt details den Hinweis von X wider und ist das zuverlässigste Einzelsignal dafür, welcher Unterfall unten zutrifft. Konto gesperrt. Beim Login bei x.com wird ein Sperrhinweis angezeigt. Maßnahme: Wenden Sie sich an den X-Support. Ein erneutes Verknüpfen stellt den Zugriff erst wieder her, wenn X das Konto wiederherstellt. Konto gesperrt (locked). Beim Login bei x.com wird eine Entsperr-Challenge (CAPTCHA, Telefonverifizierung usw.) angezeigt. Maßnahme: Schließen Sie die Entsperr-Challenge auf x.com ab und wiederholen Sie dann die Anfrage. Ein erneutes Verknüpfen ist nicht erforderlich. Identitäts- oder Schlüssel-Mismatch. Ihr X-Konto ist auf x.com in gutem Zustand, aber Ihre BYO-Consumer-Keys gehören zu einer anderen X Developer App als die zum Zeitpunkt der Verknüpfung gespeicherten OAuth-Tokens. Maßnahme: Verknüpfen Sie X unter Social Accounts erneut und autorisieren Sie mit demselben X-Konto, dem die BYO Developer App gehört. Code 416 – X-Credits erschöpft (HTTP 402) Auf Ihrem X-Developer-Konto sind keine API-Credits geladen. Alle X-API-Aufrufe erfordern Credits.
Maßnahme: Gehen Sie zu console.x.com → Billing → Credits und kaufen Sie Credits. Bereits $5 reichen für hunderte API-Aufrufe. Code 417 – OAuth 1.0a-App-Berechtigungen (HTTP 403) Ihr X-Access-Token verfügt nicht über die richtigen Berechtigungen für die angeforderte Operation.
Möglicherweise sehen Sie auch den Antwort-Header x-access-level: read, der bestätigt, dass Ihr Access-Token mit Nur-Lese-Berechtigungen generiert wurde. Maßnahme: Aktualisieren Sie in der X Developer Console die App-Berechtigungen auf Read and write and Direct message und regenerieren Sie dann Ihren Access-Token unter Keys and tokens. Der neue Token erbt die aktualisierten Berechtigungen. Details finden Sie im X BYO Key Setup Guide. Code 419 – Fehlende BYO-Anmeldedaten (HTTP 400) X/Twitter-Operationen erfordern BYO-API-Anmeldedaten in den Anfrage-Headern. Ayrshare gibt Code 419 zurück, wenn beide Header fehlen, und auch wenn nur einer des Paares vorhanden ist. Der message-String variiert je nachdem, welche(r) Header fehlt/fehlen. Wenn sowohl X-Twitter-OAuth1-Api-Key als auch X-Twitter-OAuth1-Api-Secret fehlen:
Wenn nur einer des Paares vorhanden ist (zum Beispiel der Key ohne das Secret):
Maßnahme: Senden Sie sowohl X-Twitter-OAuth1-Api-Key als auch X-Twitter-OAuth1-Api-Secret bei jeder X-Anfrage. Wenn Sie einen ohne den anderen bereitstellen, wird die Anfrage mit demselben Code abgelehnt. Die vollständige Header-Liste finden Sie unter X BYO Keys Header Reference. Code 423 – Legacy-X/Twitter-OAuth nicht mehr unterstützt (HTTP 403) Wird zurückgegeben, wenn eine X/Twitter-Anfrage den Legacy-Pfad (Nicht-BYO) OAuth verwendet, der nicht mehr unterstützt wird. Der Zugriff auf die X-API erfordert jetzt Ihre eigenen X-Developer-App-Anmeldedaten, die über Anfrage-Header bereitgestellt werden.
Maßnahme: Konfigurieren Sie eine X Developer App und senden Sie die Header X-Twitter-OAuth1-Api-Key und X-Twitter-OAuth1-Api-Secret bei jeder X-Anfrage. Die vollständigen Einrichtungsschritte finden Sie im X BYO Key Setup Guide.

Fehler bei Caption-Enhancement

Code 441 – Caption-Enhancement fehlgeschlagen (HTTP 502) Wird zurückgegeben, wenn ein Caption-Enhancement (z. B. shortenLinks) für eine oder mehrere Plattformen beim Vorbereiten eines Beitrags fehlschlägt. Jede betroffene Plattform erscheint im errors-Array mit source: "handlePostAdditions" und code: 441. Wenn nur einige Plattformen fehlschlagen, veröffentlichen die anderen Plattformen dennoch erfolgreich und ihre Ergebnisse erscheinen in postIds. In diesem Fall ist der übergeordnete status "error", aber postIds ist nicht leer – Clients sollten status und errors[] als komplementär und nicht als sich gegenseitig ausschließend behandeln.
Wenn alle Plattformen beim Enhancement fehlschlagen, ist die Antwort ein übergeordneter code: 441 mit HTTP 502, und es wird kein Beitrag erstellt:
Maßnahme: Caption-Enhancement-Fehler sind in der Regel transient (der zugrunde liegende Shortener- oder Enhancement-Dienst hat einen Fehler zurückgegeben).
  • Wenn postIds nicht leer ist (einige Plattformen haben erfolgreich veröffentlicht), senden Sie den vollständigen Plattform-Satz nicht erneut – dies würde den Beitrag auf den erfolgreichen Plattformen duplizieren. Prüfen Sie stattdessen errors[], um die fehlgeschlagenen Plattformen zu identifizieren, und wiederholen Sie die Anfrage nur mit diesen Plattformen, oder verlassen Sie sich auf Ihren eigenen idempotenten Retry-Flow.
  • Wenn postIds leer oder nicht vorhanden ist (kompletter Fehler zum Zeitpunkt des Zeitplans/Posts), können Sie die vollständige Anfrage gefahrlos wiederholen.
  • Wenn der Fehler weiter besteht, senden Sie den Beitrag ohne das Enhancement-Flag (z. B. lassen Sie shortenLinks weg) oder wenden Sie sich an den Support.

Fehler beim Medienabruf / Crawler-Zugriff

Code 440 – Soziales Netzwerk konnte Medien nicht herunterladen (HTTP 400) Wird zurückgegeben, wenn der Publishing-Crawler der Plattform die von Ihnen angegebene mediaUrl nicht herunterladen kann – am häufigsten, weil robots.txt oder eine WAF-/Bot-Fight-Regel den Crawler blockiert (z. B. Metas facebookexternalhit). Der details-String stammt von der Upstream-Plattform und ist häufig der Fehlertext 2207052 von Meta/Instagram.
Code 138 – Instagram-Medienabruf blockiert (HTTP 400) Fallback-Code für Instagram-Medienabruf-Fehler, wenn die Upstream-Antwort weniger spezifisch ist als die, die Code 440 auslöst. Der details-String enthält typischerweise "Restricted by robots.txt" oder "HTTP error code 403". Code 138 wird auch für Seitenverhältnis-/Format-Probleme und andere generische Instagram-Fehler verwendet, sodass die Medienabruf-Variante am details-String erkennbar ist.
Code 379 – Threads-Veröffentlichungsfehler Wird zurückgegeben, wenn die Threads-Veröffentlichung fehlschlägt. Am häufigsten verursacht durch dasselbe Medienabruf-Problem wie bei Codes 440 / 138, wenn auf beiden Plattformen mit derselben mediaUrl veröffentlicht wird. Die Threads-API gibt keine Detail-Strings zurück, sodass die Diagnose in der Regel erfordert, dass beim selben Veröffentlichungsvorgang gleichzeitig ein Instagram-440 oder -138 auftritt.
Maßnahme: Siehe Meta Media Crawler Blocked für die vollständige Fehlerbehebung, einschließlich robots.txt-Snippets und eines Prüfbefehls.

Facebook-Analytics-Ratenlimit

Code 444 – Facebook Page Analytics-Ratenlimit (HTTP 429) Wird zurückgegeben, wenn eine Facebook Page Metas Ratenlimit pro Page am Analytics-Endpunkt überschritten hat. Der zugrunde liegende Meta-Fehler ist 80001 („There have been too many calls to this Page account.”). Die Page bleibt verknüpft und die Veröffentlichung funktioniert weiterhin – nur der Analytics-Fan-out für diese Page ist gedrosselt. Wenn die Drosselung für einen einzelnen Beitrag in einer /history/facebook- oder analytics-Antwort erkannt wird, führt jeder betroffene Beitrag code: 444 unter facebook.code mit errCode: 80001:
Maßnahme: Warten Sie einige Minuten und versuchen Sie es erneut. Metas Ratenlimit-Fenster pro Page löst sich in der Regel innerhalb einer Stunde ohne Zutun der Page auf. Fordern Sie den Nutzer nicht auf, das Konto neu zu verknüpfen – dies ist eine transiente Drosselung auf Metas Seite und kein Autorisierungsfehler.
Wenn Sie diesen Zustand zuvor als code: 161 („Facebook authorization error … unlink and re-link”) behandelt haben, aktualisieren Sie Ihre Integration, um code: 444 zu erkennen und stattdessen mit Backoff zu wiederholen, anstatt einen Relink-Flow zu initiieren. Die Klassifizierung 161 wurde im April 2026 korrigiert.

Meta-Identitätsverifizierung

Code 326 – Meta-Identitätsverifizierung erforderlich (HTTP 403) Wird zurückgegeben, wenn Meta für das verknüpfte Konto eine zusätzliche Identitätsverifizierung verlangt, bevor die Anfrage akzeptiert wird. Dies gilt plattformübergreifend bei Meta – Facebook, Instagram, Facebook Groups, Threads und Messenger. Ein erneutes Verknüpfen des Kontos löst das Problem nicht; die Verifizierung muss auf Metas Seite abgeschlossen werden.
Maßnahme: Lassen Sie den Kontoinhaber Metas Identitätsverifizierung unter Meta Business Support abschließen und wiederholen Sie dann die Anfrage. Fordern Sie den Nutzer nicht auf, das Konto neu zu verknüpfen – ein Relink löscht diese Anforderung nicht.

Facebook-Konto-Einschränkung

Code 476 – Facebook-Konto-Einschränkung (HTTP 400) Wird zurückgegeben, wenn ein Beitrag auf Facebook fehlschlägt, weil Meta eine Einschränkung für das Konto verhängt hat (Meta-Fehler-Subcodes 2424009 und 1404078 oder Metas Restriktions-Wortlaut, wenn der Fehler keinen Subcode trägt). Dies ist eine Einschränkung auf Kontoebene, kein vorübergehender Veröffentlichungsfehler – sie ist nicht wiederholbar und trägt kein retryAvailable-Flag. Ein erneutes Senden desselben Beitrags wird erst erfolgreich sein, wenn die Einschränkung mit Meta geklärt ist. Das Konto bleibt mit Ayrshare verknüpft; ein Relink ist nicht erforderlich. Meta gibt den spezifischen Grund für die Einschränkung nicht über die API zurück, sodass der Kunde Metas Kontostatus-Seite direkt prüfen muss, um den Grund zu sehen und Einspruch zu erheben. Wenn Meta einen eigenen Wortlaut liefert, gibt Ayrshare diesen im Feld details wieder. Ayrshare sendet dem Kontoinhaber außerdem eine Benachrichtigungs-E-Mail, wenn die Einschränkung erkannt wird.
Maßnahme: Melden Sie sich bei Facebook an, klicken Sie auf Ihr Profilbild (oben rechts), öffnen Sie den Bereich Hilfe und wählen Sie Kontostatus. Metas Support-Assistent dort zeigt den spezifischen Grund für die Einschränkung an und ermöglicht Ihnen Einspruch. Da die Einschränkung von Meta auf Kontoebene durchgesetzt wird, ist dieser Code nicht wiederholbar – bauen Sie keine automatische Retry-Logik darum herum; klären Sie die Einschränkung zuerst mit Meta.

Fehler bei der Bildformatkonvertierung

Ayrshare konvertiert WebP-, HEIC- und AVIF-Bilder automatisch in JPEG, bevor auf Plattformen veröffentlicht wird, die sie nicht akzeptieren (Instagram, LinkedIn, TikTok, Google My Business, Threads und Snapchat für WebP; alle Plattformen für HEIC und AVIF). Die Konvertierung läuft transparent zum Zeitpunkt des Sendens. Die drei folgenden Fehler treten nur auf, wenn die Konvertierungspipeline selbst nicht abgeschlossen werden kann; wenn das Quellbild bereits in einem unterstützten Format vorliegt, wird keine Konvertierung versucht und diese Codes erscheinen nicht. Code 450 – Bildformatkonvertierung fehlgeschlagen (HTTP 400) Das Bild wurde heruntergeladen, konnte aber nicht als JPEG neu kodiert werden. Häufigste Ursachen sind eine beschädigte Quelldatei, ein unerwartetes internes Format im Container oder ein Bild, das die Konvertierungs-Größenobergrenze überschreitet.
Maßnahme: Öffnen Sie die Quell-mediaUrl direkt in einem Browser, um zu bestätigen, dass sie dargestellt wird. Wenn ja, exportieren Sie das Bild in ein sauberes JPEG oder PNG und wiederholen Sie den Beitrag. Code 451 – Bilddownload für Konvertierung fehlgeschlagen (HTTP 400) Die Konvertierungspipeline konnte das Quellbild nicht abrufen. Typische Ursachen sind eine 4xx-/5xx-Antwort vom Ursprung, ein Netzwerk-Timeout, eine Weiterleitungskette, die die Hop-Grenze überschreitet, oder eine URL, die zu einer nicht-öffentlichen Adresse aufgelöst wird (durch die SSRF-Guard blockiert). Das Feld details enthält, sofern vorhanden, den zugrunde liegenden Ursachen-String.
Maßnahme: Bestätigen Sie, dass die mediaUrl öffentlich erreichbar ist (keine Authentifizierung, keine robots.txt-Blockaden, wird über HTTPS aufgelöst). Wenn die URL umleitet, stellen Sie sicher, dass auch das endgültige Ziel öffentlich ist und sich nicht in einem privaten Netzwerk befindet. Code 452 – Upload des konvertierten Bildes fehlgeschlagen (HTTP 500) Die Konvertierung war erfolgreich, aber Ayrshare konnte das konvertierte JPEG nicht in seinem temporären Storage-Bucket ablegen. Dies ist ein interner Fehler auf Ayrshare-Seite und wiederholbar.
Maßnahme: Wiederholen Sie den Beitrag. Wenn der Fehler über mehrere Wiederholungen hinweg bestehen bleibt, wenden Sie sich mit der mediaUrl und dem ungefähren Zeitstempel an den Support.

Transiente YouTube-Upload-Fehler

Die folgenden Fehlercodes liefern spezifische Signale für YouTube-Upload-Fehler, die typischerweise transient sind und sich sicher wiederholen lassen. Beide Antworten enthalten retryAvailable: true, sodass Integrationen auf dieses Boolean und nicht auf den HTTP-Statuscode verzweigen können. Die meisten früheren code: 176-Antworten für YouTube-Uploads werden jetzt auf 453 (transientes Timeout) oder 454 (transient Dienst nicht verfügbar) geleitet, beide mit retryAvailable: true. Wenn Ihre Integration nach HTTP 500 filtert, um YouTube-Uploads zu wiederholen, wechseln Sie zum Filtern auf das Feld retryAvailable im Antwort-Body. Code 453 – YouTube-Upload-Timeout (HTTP 504) Wird zurückgegeben, wenn Googles YouTube-Ingest-Pipeline beim Annehmen des Uploads ein Timeout hatte. Dies ist in der Regel transient und löst sich innerhalb von ein bis zwei Minuten von selbst.
Maßnahme: Wiederholen Sie den Beitrag nach 1–2 Minuten mit exponentiellem Backoff. Verzweigen Sie auf das Feld retryAvailable im Antwort-Body und nicht auf den HTTP-Status, um wiederholbare Fehler zu erkennen. Sie können den retry post-Endpunkt verwenden, um dasselbe Payload erneut zu senden. Code 454 – YouTube-Upload-Dienst vorübergehend nicht verfügbar (HTTP 503) Wird zurückgegeben, wenn YouTubes Upload-Endpunkt einen 5xx-Status zurückgibt oder wenn die Verbindung zu YouTube auf Socket-Ebene zurückgesetzt wurde oder ein Timeout hatte (ECONNRESET, ETIMEDOUT, ESOCKETTIMEDOUT). Diese Zustände sind transient.
Maßnahme: Wiederholen Sie den Beitrag mit exponentiellem Backoff. Verzweigen Sie auf das Feld retryAvailable im Antwort-Body und nicht auf den HTTP-Status, um wiederholbare Fehler zu erkennen. Sie können den retry post-Endpunkt verwenden, um dasselbe Payload erneut zu senden.

YouTube-Thumbnail-Fehler Code 307

Code 307 wird zurückgegeben, wenn ein benutzerdefiniertes YouTube-thumbNail nicht angewendet werden kann. Wenn das Video selbst erfolgreich veröffentlicht wird, führt dies nicht zum Fehlschlagen des Beitrags – das YouTube-Ergebnis behält status: "success" und meldet den Fehler zusätzlich in einem warnings-Array (feature: "thumbnail", code: 307). Das ältere thumbnail-Unterobjekt bleibt aus Gründen der Abwärtskompatibilität erhalten. Die häufigste Ursache ist ein nicht verifizierter YouTube-Kanal. Wenn ein Kanal die Telefonverifizierung nicht abgeschlossen hat, gibt YouTube einen Upstream-403 mit der generischen Meldung "The authenticated user doesn't have permissions to upload and set custom video thumbnails" zurück. Dieser Wortlaut klingt nach einem OAuth-Problem, ist in der Praxis aber fast immer ein Verifizierungsproblem, verifizieren Sie also zunächst den Kanal. Ein erneutes Verknüpfen des YouTube-Kontos ist eine zweitrangige Ursache.
Ayrshare validiert das Thumbnail nach Möglichkeit auch vor dem Veröffentlichen: Die Datei muss ein PNG oder JPG/JPEG sein, 2 MB oder weniger groß sein und von einer erreichbaren URL ausgeliefert werden. Ein Thumbnail-Problem lässt den Beitrag niemals scheitern – das Video wird immer veröffentlicht, und der Fehler wird stets als nicht-fataler warnings-Eintrag gemeldet (der übergeordnete status bleibt "success"). Dies gilt unabhängig davon, wann das Problem erkannt wird:
  • Vor dem Upload erkannt. Wenn die Pre-Publish-Validierung eindeutig feststellen kann, dass das Thumbnail ungültig ist (falscher Dateityp, bestätigt über 2 MB oder eine nicht erreichbare URL), überspringt Ayrshare das Thumbnail, veröffentlicht das Video dennoch und meldet den genauen Grund unter warnings – so vermeiden Sie einen zum Scheitern verurteilten Upload-Versuch und erhalten eine klarere Meldung als vom Anbieter zurückgegeben würde.
  • Nach dem Upload erkannt. Wenn der Fehler erst nach der Verarbeitung durch YouTube erkennbar ist (z. B. der 403 bei nicht verifiziertem Kanal oder ein 413 bei einem übergroßen Bild), ist das Video bereits live und der Fehler wird im selben warnings-Array gemeldet.
In beiden Fällen sieht die Antwort wie das oben in diesem Abschnitt gezeigte Beispiel mit status: "success" + warnings aus. Maßnahme: Verifizieren Sie Ihren YouTube-Kanal unter https://www.youtube.com/verify (Telefonverifizierung). Wenn Ihr Kanal bereits verifiziert ist und Thumbnails weiterhin fehlschlagen, trennen und verknüpfen Sie Ihr YouTube-Konto in Social Accounts neu und gewähren Sie alle Berechtigungen. Den vollständigen Leitfaden zur Fehlerbehebung finden Sie unter YouTube Thumbnail Not Applied (Unverified Channel).

Reddit-Veröffentlichungsfehler

Code 442 – Reddit gesperrtes Subreddit (HTTP 400) Wird zurückgegeben, wenn das Konto vom Posten im Ziel-Subreddit gesperrt wurde. Dies ist nicht wiederholbar – der Beitrag wird nicht erfolgreich sein, wenn er unverändert erneut gesendet wird. Die Meldung enthält den Namen des betroffenen Subreddits (zum Beispiel r/news).
Maßnahme: Entfernen Sie das gesperrte Subreddit aus Ihren Ziel-Subreddits. Ein unverändertes erneutes Senden des Beitrags wird nicht erfolgreich sein. Code 443 – Reddit nicht erlaubtes Wort im Titel (HTTP 400) Wird zurückgegeben, wenn ein Subreddit den Beitrag ablehnt, weil sein Titel ein nicht erlaubtes Wort enthält. Bearbeiten Sie den Titel vor dem erneuten Senden – ein unverändertes erneutes Senden wird nicht erfolgreich sein. Die Meldung enthält den Namen des betroffenen Subreddits (zum Beispiel r/news).
Maßnahme: Bearbeiten Sie den Beitragstitel, um das nicht erlaubte Wort zu entfernen, und wiederholen Sie dann.

Moderationsfehler

Code 438 – Moderations-Eingabe abgelehnt (HTTP 400) Wird von POST /validate/moderation zurückgegeben, wenn der KI-Anbieter die bereitgestellte Eingabe ablehnt – zum Beispiel einen nicht unterstützten Dateityp. Dies ist ein Eingabeproblem der Anfrage, kein vorübergehender Verarbeitungsfehler.
Maßnahme: Prüfen Sie, ob die Moderations-Eingabe gültig ist und einen unterstützten Dateityp verwendet, und senden Sie sie dann erneut.
Vergleichen Sie Code 438 mit Code 331. Code 331 deckt dasselbe Moderationsszenario ab, stellt aber einen echten Verarbeitungsfehler auf Anbieterseite dar (HTTP 500, Meldung „There was an issue with the AI processing. Please try again.”). Code 331 ist ein transienter serverseitiger Fehler, den Sie wiederholen können, während Code 438 anzeigt, dass die Eingabe selbst abgelehnt wurde und vor dem erneuten Versuch korrigiert werden muss.

LinkedIn-Analytics-Fehler

Code 475 – LinkedIn-Profil für Analytics neu verknüpfen (HTTP 403) Wird von POST /analytics/post und POST /analytics/social für ein persönliches (Member-)LinkedIn-Profil zurückgegeben, das verknüpft wurde, bevor Member-Analytics veröffentlicht wurden. Diesen Profilen fehlen die LinkedIn-Member-Analytics-Scopes (r_member_postAnalytics, r_member_profileAnalytics), sodass LinkedIn die Analytics-Anfrage ablehnt. Das Posten ist davon nicht betroffen.
Maßnahme: Lassen Sie den Kontoinhaber sein LinkedIn-Profil in Social Accounts neu verknüpfen, um die neuen Analytics-Scopes zu gewähren, und wiederholen Sie dann die Analytics-Anfrage. Nach der erneuten Verknüpfung dauert es einige Minuten, bis der Fehler behoben ist: Ayrshare speichert diesen Fehler kurz im Cache, und LinkedIn cacht auch die Berechtigungen des Tokens, sodass ein neu verknüpftes Profil bis zu ca. 5–10 Minuten lang weiterhin Code 475 zurückgeben kann, bevor Analytics gelingt.

TikTok-Kommentarfehler

Code 288 – TikTok-Kommentar verschoben / Beitrag wird noch verarbeitet (HTTP 400) TikTok verarbeitet Videos asynchron, daher ist die id eines frisch veröffentlichten Beitrags "pending", bis TikToks Webhook post.publish.publicly_available die tatsächliche Video-ID auflöst. Eine get-comments-, Kommentar- oder Antwortanfrage gegen einen Beitrag, der noch verarbeitet wird (oder dessen id "failed" ist), wird vor jedem Aufruf an TikTok abgelehnt und gibt Code 288 anstelle eines generischen Fehlers zurück.
Maßnahme: Warten Sie, bis TikTok die Verarbeitung abgeschlossen hat, und wiederholen Sie dann. Hören Sie auf den Scheduled Action Webhook tikTokPublished oder pollen Sie /history, bis die id des Beitrags die aufgelöste numerische Video-ID ist. Ein first comment wird automatisch gepostet, sobald der Beitrag aufgelöst ist, sodass er nicht erneut ausgeführt werden muss. Bei einem "failed"-Beitrag weist die Meldung stattdessen darauf hin, dass das Video nicht veröffentlicht werden konnte und die Aktion nicht ausgeführt wird.

Übersetzung von Fehlermeldungen

Die API-Fehlermeldungsantwort kann automatisch in die Sprache Ihrer Wahl übersetzt werden. Dies ist nützlich, wenn Sie den Fehler direkt Ihrem Nutzer in seiner bevorzugten Sprache anzeigen möchten. Siehe hier, wenn Sie die Sprache der Social-Linking-Seite wählen möchten. Fügen Sie im Header Folgendes hinzu:
Wobei Language_Code einer der verfügbaren Sprachcodes ist. Zum Beispiel übersetzt Folgendes den Fehler ins Französische.
Unser System erkennt die Sprache der Fehlermeldung automatisch.