> ## Documentation Index > Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Ayrshare-Fehlercodes > Von Ayrshare zurückgegebene spezifische Fehlercodes. 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](/errors/errors-http). 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. ```json theme={"system"} { "status": "error", "errors": [ { "action": "post", "status": "error", "code": 110, "message": "Status is a duplicate.", "post": "Today is a great day", "platform": "twitter" }, { "action": "post", "status": "error", "code": 107, "message": "Facebook Error: This status update is identical to the last one you posted. Try posting something different, or delete your previous update.", "platform": "facebook" } ], "postIds": [], "id": "6APU4qqI7XO7JM3BOy6B" } ``` Bitte beachten Sie: ### Fehlerbehandlung Sie sollten alle Fehlerantworten behandeln und die entsprechenden Maßnahmen ergreifen. Ein Fehler ist aufgetreten, wenn: 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. ```json theme={"system"} { "status": "error", "errors": [ { "action": "post", "status": "error", "code": 161, "message": "Facebook authorization error. This can occur if your Facebook security changes. Try unlinking and re-linking Facebook or contact us for assistance.", "platform": "facebook" } ], "postIds": [], "id": "gh7SyTpeD2CQAMxWk3oh", "post": "A great Facebook Posts" } ``` 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`: ```json theme={"system"} { "status": "error", "errors": [ { "action": "post", "status": "error", "code": 138, "message": "Instagram Error: There was an issue posting to Instagram. The submitted image with aspect ratio ('1440/2158',) cannot be published. Please submit an image with a valid aspect ratio.", "platform": "instagram" } ], "postIds": [], "id": "Jxe2nMM3FmEvMXFSY3g4", "post": "Is this a good image?" } ``` 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](https://developers.facebook.com/docs/instagram-platform/instagram-graph-api/reference/ig-user/content_publishing_limit/) (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. ```json theme={"system"} { "status": "error", "errors": [ { "action": "rate limit", "status": "error", "code": 435, "message": "Instagram rate limit reached. Please wait before retrying your post.", "details": "Retry-After: 3600", "platform": "instagram" } ] } ``` **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. ```json theme={"system"} { "status": "error", "errors": [ { "action": "post", "status": "error", "code": 436, "message": "Instagram media processing timed out. Please try posting again.", "retryAvailable": true, "platform": "instagram" } ] } ``` **Maßnahme:** Wiederholen Sie den Beitrag über den [retry post](/apis/post/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`](/apis/post/post)-Anfrage angegeben ist, aber `graduationStrategy` fehlt, `null` oder ein leerer String ist. Trial Reels erfordern eine explizite Graduation-Strategie – siehe [Trial Reels](/apis/post/social-networks/instagram#trial-reels). ```json theme={"system"} { "status": "error", "errors": [ { "action": "post", "status": "error", "code": 447, "message": "Instagram trial reels require instagramOptions.trialParams.graduationStrategy (\"MANUAL\" or \"SS_PERFORMANCE\").", "platform": "instagram" } ] } ``` **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. ```json theme={"system"} { "status": "error", "errors": [ { "action": "post", "status": "error", "code": 448, "message": "Invalid Instagram graduationStrategy. Must be \"MANUAL\" or \"SS_PERFORMANCE\".", "details": "Received: manual", "platform": "instagram" } ] } ``` **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. ```json theme={"system"} { "status": "error", "errors": [ { "action": "post", "status": "error", "code": 449, "message": "Instagram trial reels must be a single video (.mp4 or .mov) — carousels and stories are not supported.", "details": "Carousels are not supported.", "platform": "instagram" } ] } ``` **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. ```json theme={"system"} { "status": "error", "errors": [ { "action": "post", "status": "error", "code": 258, "message": "Error with Instagram.", "platform": "instagram" } ] } ``` 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: ```json theme={"system"} { "status": "error", "errors": [ { "action": "post", "status": "error", "code": 258, "message": "Error with Instagram. Please unlink and relink your Instagram account, granting all permissions, then retry.", "relink": true, "retryAvailable": true, "platform": "instagram" } ] } ``` **Maßnahme:** Für den Unterfall `2207085` fordern Sie den Nutzer auf, sein Instagram-Konto in [Social Accounts](https://app.ayrshare.com/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`. ```json theme={"system"} { "retryAvailable": 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](/apis/post/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](https://x.com) mit dem Konto anmelden, dem die BYO Developer App gehört. Der Post-Pfad gibt eine minimale Antwort aus: ```json theme={"system"} { "status": "error", "code": 272, "message": "Failed to verify BYO Twitter identity", "platform": "twitter" } ``` Der Analytics-Pfad gibt eine ausführlichere, selbstdokumentierende Meldung aus und kann ein Feld `details` mit der Roh-Fehlermeldung von X enthalten: ```json theme={"system"} { "action": "post", "status": "error", "code": 272, "message": "There is an issue authorizing your X/Twitter account. Login to x.com to verify your account status and then try unlinking Twitter and relinking on the social accounts page.", "resolution": { "relink": true, "platform": "twitter" }, "details": "The user used for authentication is suspended" } ``` 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. ```json theme={"system"} { "status": "error", "code": 416, "message": "Your enrolled account does not have any credits to fulfill this request. Purchase credits at console.x.com.", "platform": "twitter" } ``` **Maßnahme:** Gehen Sie zu [console.x.com](https://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. ```json theme={"system"} { "status": "error", "code": 417, "message": "Your client app is not configured with the appropriate oauth1 app permissions. Set app to 'Read and write and Direct message', then regenerate your Access Token.", "platform": "twitter" } ``` 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](/dashboard/connect-social-accounts/x-twitter-byo-keys#troubleshooting). **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: ```json theme={"system"} { "action": "x_credentials_required", "status": "error", "code": 419, "message": "X/Twitter operations require your own API credentials. Missing: X-Twitter-OAuth1-Api-Key, X-Twitter-OAuth1-Api-Secret. Please provide your X Developer App credentials in the request headers. See https://docs.ayrshare.com/x-api-setup for setup instructions.", "resolution": { "docs": "https://docs.ayrshare.com/x-api-setup" }, "platform": "twitter" } ``` Wenn nur einer des Paares vorhanden ist (zum Beispiel der Key ohne das Secret): ```json theme={"system"} { "action": "x_credentials_required", "status": "error", "code": 419, "message": "You provided X-Twitter-OAuth1-Api-Key but not X-Twitter-OAuth1-Api-Secret. OAuth 1.0a requires both. Missing: X-Twitter-OAuth1-Api-Secret. See https://docs.ayrshare.com/x-api-setup for setup instructions.", "resolution": { "docs": "https://docs.ayrshare.com/x-api-setup" }, "platform": "twitter" } ``` **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](/dashboard/connect-social-accounts/x-twitter-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. ```json theme={"system"} { "status": "error", "code": 423, "message": "X (Twitter) API access now requires your own API credentials. Include X-Twitter-OAuth1-Api-Key and X-Twitter-OAuth1-Api-Secret headers in your request. Setup guide: https://docs.ayrshare.com/dashboard/connect-social-accounts/x-twitter-byo-keys", "platform": "twitter" } ``` **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](/dashboard/connect-social-accounts/x-twitter-byo-keys). ### Fehler bei Caption-Enhancement **Code 441 – Caption-Enhancement fehlgeschlagen (HTTP 502)** Wird zurückgegeben, wenn ein Caption-Enhancement (z. B. [`shortenLinks`](/apis/post/post)) 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. ```json theme={"system"} { "status": "error", "errors": [ { "platform": "twitter", "status": "error", "source": "handlePostAdditions", "code": 441, "message": "Caption enhancement failed for twitter. . Post was not sent to this platform." } ], "postIds": [ { "status": "success", "id": "...", "postUrl": "...", "platform": "bluesky" } ], "id": "..." } ``` Wenn **alle** Plattformen beim Enhancement fehlschlagen, ist die Antwort ein übergeordneter `code: 441` mit HTTP `502`, und es wird kein Beitrag erstellt: ```json theme={"system"} { "status": "error", "action": "post", "code": 441, "message": "Caption enhancement failed. See error details for affected platforms.", "errors": [ { "platform": "twitter", "status": "error", "source": "handlePostAdditions", "code": 441, "message": "Caption enhancement failed for twitter. " } ] } ``` **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. ```json theme={"system"} { "status": "error", "errors": [{ "action": "post", "code": 440, "message": "The social network could not download media from this URL (for example Instagram/Meta error 2207052). Ensure the file is publicly reachable by the platform's crawlers (e.g. facebookexternalhit), via media bucket's robots.txt file, not only in a browser.", "details": "Media download has failed.: The media could not be fetched from the provided URI...", "platform": "instagram", "status": "error" }], "postIds": [], "id": "..." } ``` **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. ```json theme={"system"} { "status": "error", "errors": [{ "retryAvailable": true, "status": "error", "code": 138, "details": "Media download has failed.: The media could not be fetched from the provided URI. Video download failed with: HTTP error code 403. Restricted by robots.txt", "action": "post", "platform": "instagram", "message": "Instagram Error: Instagram cannot process your post at this time. Please try your post again." }], "postIds": [], "id": "..." } ``` **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. ```json theme={"system"} { "status": "error", "errors": [{ "status": "error", "code": 379, "message": "Error posting to Threads.", "action": "post", "platform": "threads" }], "postIds": [], "id": "..." } ``` **Maßnahme:** Siehe [Meta Media Crawler Blocked](/help-center/technical-support/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`](/apis/history/history-platform)- oder [analytics](/apis/analytics/social)-Antwort erkannt wird, führt jeder betroffene Beitrag `code: 444` unter `facebook.code` mit `errCode: 80001`: ```json theme={"system"} { "status": "error", "facebook": { "action": "rate limit", "status": "error", "code": 444, "errCode": 80001, "message": "Facebook Page has hit its per-Page rate limit on the analytics endpoint. Please wait a few minutes and retry.", "pageId": "...", "id": "..." }, "httpErrorCode": 444, "lastUpdated": "...", "nextUpdate": "..." } ``` **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. ```json theme={"system"} { "status": "error", "errors": [ { "action": "post", "status": "error", "code": 326, "message": "Meta is requesting additional identity verification for this account. Complete it at https://www.facebook.com/business-support-home and then retry. Reconnecting the account will not resolve this.", "platform": "facebook" } ] } ``` **Maßnahme:** Lassen Sie den Kontoinhaber Metas Identitätsverifizierung unter [Meta Business Support](https://www.facebook.com/business-support-home) 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. ```json theme={"system"} { "status": "error", "errors": [ { "action": "post", "status": "error", "code": 476, "message": "There is a Facebook restriction on your account. Log in to Facebook, click your profile picture (top-right), open the Help section and select Account Status. Meta's support assistant there surfaces the specific restriction reason (which the API doesn't return) and lets you appeal.", "details": "...", "platform": "facebook" } ] } ``` **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. ```json theme={"system"} { "status": "error", "errors": [ { "action": "image conversion", "status": "error", "code": 450, "message": "The image format could not be converted. The source image may be corrupt or inaccessible. Please verify the media URL and try again.", "platform": "instagram" } ] } ``` **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. ```json theme={"system"} { "status": "error", "errors": [ { "action": "image conversion", "status": "error", "code": 451, "message": "The image could not be downloaded for format conversion.", "details": "HTTP 403 from origin", "platform": "linkedin" } ] } ``` **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. ```json theme={"system"} { "status": "error", "errors": [ { "action": "image conversion", "status": "error", "code": 452, "message": "An error occurred uploading the converted image. Please try again.", "platform": "tiktok" } ] } ``` **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. ```json theme={"system"} { "status": "error", "errors": [ { "action": "post", "status": "error", "code": 453, "message": "YouTube upload timed out (Google ingest). This is typically transient; please retry in 1–2 minutes.", "retryAvailable": true, "platform": "youtube" } ] } ``` **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](/apis/post/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. ```json theme={"system"} { "status": "error", "errors": [ { "action": "post", "status": "error", "code": 454, "message": "YouTube upload service temporarily unavailable. Please retry.", "retryAvailable": true, "platform": "youtube" } ] } ``` **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](/apis/post/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. ```json theme={"system"} { "status": "success", "id": "", "thumbnail": { "action": "post", "status": "error", "code": 307, "message": "Your YouTube channel must be verified to set a custom thumbnail. Verify your channel at https://www.youtube.com/verify (phone verification). If your channel is already verified, try unlinking and re-linking your YouTube account to restore permissions.", "details": "" }, "warnings": [ { "feature": "thumbnail", "code": 307, "message": "Your YouTube channel must be verified to set a custom thumbnail. Verify your channel at https://www.youtube.com/verify (phone verification). If your channel is already verified, try unlinking and re-linking your YouTube account to restore permissions.", "details": "" } ] } ``` 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](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](https://app.ayrshare.com/social-accounts) neu und gewähren Sie alle Berechtigungen. Den vollständigen Leitfaden zur Fehlerbehebung finden Sie unter [YouTube Thumbnail Not Applied (Unverified Channel)](/help-center/technical-support/youtube_thumbnail_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`). ```json theme={"system"} { "status": "error", "errors": [ { "action": "post", "status": "error", "code": 442, "message": "You've been banned from posting to r/news. This post will not succeed on retry — remove it from your target subreddits.", "platform": "reddit" } ] } ``` **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`). ```json theme={"system"} { "status": "error", "errors": [ { "action": "post", "status": "error", "code": 443, "message": "r/news rejected this post because the title contains a disallowed word. Edit the title before retrying — retrying as-is will not succeed.", "platform": "reddit" } ] } ``` **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`](/apis/post/post) 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. ```json theme={"system"} { "status": "error", "errors": [ { "action": "moderation", "status": "error", "code": 438, "message": "There was an issue with the AI processing." } ] } ``` **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`](/apis/analytics/post) und [`POST /analytics/social`](/apis/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. ```json theme={"system"} { "action": "authorization", "status": "error", "code": 475, "message": "Your LinkedIn profile is missing the analytics permissions. Please re-link your LinkedIn profile to enable analytics.", "resolution": { "relink": true, "platform": "linkedin" } } ``` **Maßnahme:** Lassen Sie den Kontoinhaber sein LinkedIn-Profil in [Social Accounts](https://app.ayrshare.com/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](/apis/comments/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. ```json theme={"system"} { "status": "error", "errors": [ { "action": "get", "status": "error", "code": 288, "message": "TikTok video is still processing; the action is deferred until the post is live.", "platform": "tiktok" } ] } ``` **Maßnahme:** Warten Sie, bis TikTok die Verarbeitung abgeschlossen hat, und wiederholen Sie dann. Hören Sie auf den [Scheduled Action Webhook `tikTokPublished`](/apis/webhooks/actions#scheduled-action) oder pollen Sie [/history](/apis/history/overview), bis die `id` des Beitrags die aufgelöste numerische Video-ID ist. Ein [first comment](/apis/post/overview#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](/multiple-users/manage-user-profiles#set-language-for-the-social-linking-page). Fügen Sie im Header Folgendes hinzu: ```json theme={"system"} "Translate-Error-Message": "Language_Code" ``` Wobei `Language_Code` einer der verfügbaren [Sprachcodes](/iso-codes/language) ist. Zum Beispiel übersetzt Folgendes den Fehler ins Französische. ```json theme={"system"} "Translate-Error-Message": "fr" // Translate to French ``` Unser System erkennt die Sprache der Fehlermeldung automatisch.