Skip to main content
Jeder Fehler, den /submit zurückgibt, folgt derselben Struktur: der passende HTTP-Statuscode, plus ein JSON-Body mit success: false, einem stabilen code und einer menschenlesbaren message.
code ist der Teil, auf den es sich zu achten lohnt, er ändert sich zwischen Releases nicht so, wie es der message-Text tun könnte. Wenn du einen Agenten baust oder Code, der auf einen bestimmten Fehler reagieren muss (erneut versuchen, zu einer Korrektur auffordern, einen bestimmten UI-Zustand anzeigen), lies code, nicht message.

Alle Codes

Diese Tabelle nutzen

  • Menschen: Gleiche den code, den der Fehlerhandler deines Formulars protokolliert hat (oder den, der bei einem fehlgeschlagenen Test-Versand im Dashboard angezeigt wird), mit dieser Tabelle ab, um herauszufinden, was schiefgelaufen ist.
  • Agenten: Lies code, um dich selbst zu korrigieren. invalid_access_key bedeutet, überprüfe erneut den Schlüssel, den du eingebunden hast; domain_not_allowed bedeutet, die einsendende Origin steht noch nicht auf der Zulassungsliste des Formulars; upgrade_required bedeutet, das Feld oder Feature, das du verwenden möchtest, ist nur für Pro. Siehe Fehlerbehebung & FAQ für die häufigsten Fälle, die auf Lösungen abgebildet sind.

Optionsreferenz

Die reservierten Felder und die Formular-Konfiguration, auf die sich jeder Fehler bezieht.

Fehlerbehebung & FAQ

Häufige Probleme, abgebildet auf die obigen Codes.