Fehlerbehandlung

Prüfe HTTP-Status und Antwort gemeinsam. Fehlerfelder unterscheiden sich je nach Endpunkt; den genauen Vertrag findest du in der API-Referenz.

Prüfe bei einem Timeout oder vorübergehenden 5xx-Fehler zuerst erhaltene Inhalts- oder Auftrags-IDs. Behalte für dieselbe Operation Inhalt und idempotency_key bei und begrenze Wiederholungen mit zunehmender Wartezeit. HTTP 202 bedeutet Annahme, keine erfolgreiche Veröffentlichung.
Vergleiche bei 409 idempotency_conflict die ursprüngliche Anfrage und ihr Ergebnis. Erzeuge nicht automatisch einen neuen Schlüssel. Verwende ihn nur für eine bewusst neue Operation, nachdem das vorherige Ergebnis geklärt ist.
Behebe ungültige Eingaben sowie Authentifizierungs- oder Berechtigungsprobleme vor einem neuen Versuch. Prüfe bei 429 den Fehler und gegebenenfalls Retry-After: Verbrauchte Tarifkontingente erfordern möglicherweise eine Rücksetzung oder einen Tarifwechsel statt kurzer Wartezeit.

{
  "error": "insufficient_scope",
  "message": "publishing:write scope is required for this API request."
}