Geprüft am 2026-11-10 · API-Version 2026-11-09 · Markdown lesen
Fehler, Wiederholungen und Wiederherstellung
API-Fehler verwenden { "error": { "code": "…", "message": "…", "requestId": "…" } }
mit optionalen Feldfehlern, Zielfehlern, Wiederholungshinweisen und Aktionsübergaben.
Bewahre requestId für den Support auf. Logge keine Zugangsdaten, signierten Upload-URLs oder
sensiblen Anfrageinhalte, wenn du Diagnostik sammelst.
| Antwort | Wiederherstellung |
|---|---|
401 unauthenticated | Prüfe fehlenden, fehlerhaften oder widerrufenen Produktkey |
403 forbidden_scope / account_not_allowed | Prüfe Key-Scopes und Zielzugriff |
402 account_limit, seat_limit, storage_limit | Prüfe Arbeitsbereichs-Berechtigungen und Ressourcennutzung |
402 subscription_inactive / trial_expired | Behebe den Abrechnungsstatus; bewahre Entwürfe und eingereihte Arbeit auf |
409 revision_conflict | Lies die aktuelle Version, prüfe Änderungen und wende sie bewusst erneut an |
409 idempotency_conflict | Der Key wurde mit einem anderen Body wiederverwendet; stimme die ursprüngliche Operation ab |
409 consent_required | Bitte eine autorisierte Person, die bereitgestellte Prüfungsübergabe abzuschließen |
409 too_late_to_cancel | Prüfe den tatsächlichen Zustellungsstatus; behaupte nicht, der Abbruch sei erfolgreich gewesen |
media_expired / media_deleting | Lade Originale erneut hoch und aktualisiere den Entwurf |
422 validation_failed | Korrigiere strukturierte Felder oder Probleme pro Ziel |
429 rate_limited | Beachte Retry-After; reduziere Nebenläufigkeit und verwende Backoff |
submission_unknown | Stimme das vorhandene externe Ergebnis ab, bevor du eine weitere Übermittlung versuchst |
Sichere Mutations-Wiederholungen
Erzeuge einen Idempotency-Key vor der ersten Mutation und speichere ihre exakte Anfrage.
Wenn die Antwort verloren geht, kann die Operation bereits erfolgreich gewesen sein. Wiederhole die
gleiche Anfrage mit demselben Key; erzeuge niemals einen neuen Key nur, weil das
Netzwerk einen Timeout hatte. Mutierende MCP-Tools geben ihren Key zurück, auch bei
transport_outcome_unknown-Fehlern. Der Adapter wiederholt Mutationen nicht automatisch.
Technische Geschwindigkeitsbegrenzungen des Arbeitsbereichs sind keine Posting-Guthaben. Verwende /usage für den
aktuellen Plan und Rate-Informationen. Warte nur bei vorübergehenden Fehlern angemessen ab;
Autorisierungs-, Validierungs- oder Zustimmungsfehler ohne Änderung ihrer Ursache erneut zu wiederholen,
hilft nicht.
Teilerfolg und Beobachtung
Ein angenommener Publish-/Schedule-Batch ist eine Menge unabhängiger Zustellungen. Bewahre erfolgreiche Belege und native Links auf. Stelle ein fehlgeschlagenes Ziel über seinen eigenen Retry-Endpunkt wieder her, statt den ganzen Batch erneut zu erstellen. Bevorzuge signierte Webhooks; falls Polling, verwende eine begrenzte Anzahl von Versuchen mit zunehmenden Verzögerungen und leite ungelöste Arbeit an eine Person weiter.