> ## Documentation Index
> Fetch the complete documentation index at: https://formpaste.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Fehlerreferenz

> Jeder Fehler, den /submit zurückgeben kann, Code, HTTP-Status und Bedeutung.

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`.

```json theme={null}
{ "success": false, "code": "invalid_access_key", "message": "The access_key is not valid." }
```

`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

| Code                   | HTTP | Bedeutung                                                                 |
| ---------------------- | ---- | ------------------------------------------------------------------------- |
| `missing_access_key`   | 400  | Es wurde kein access\_key angegeben.                                      |
| `invalid_access_key`   | 401  | Der access\_key ist nicht gültig.                                         |
| `invalid_body`         | 400  | Der Request-Body konnte nicht als JSON oder Formulardaten geparst werden. |
| `empty_submission`     | 400  | Die Einsendung enthielt keine Felder.                                     |
| `payload_too_large`    | 413  | Der Request-Body ist zu groß.                                             |
| `method_not_allowed`   | 405  | Auf diesem Endpunkt ist nur POST erlaubt.                                 |
| `domain_not_allowed`   | 403  | Dieses Formular akzeptiert keine Einsendungen von dieser Domain.          |
| `internal_error`       | 500  | Ein unerwarteter Fehler ist aufgetreten.                                  |
| `rate_limited`         | 429  | Zu viele Anfragen. Bitte verlangsame und versuche es in Kürze erneut.     |
| `invalid_redirect`     | 400  | Die Redirect-URL ist für dieses Formular nicht erlaubt.                   |
| `too_many_fields`      | 400  | Die Einsendung hat zu viele Felder.                                       |
| `field_too_large`      | 400  | Ein Feld der Einsendung ist zu groß.                                      |
| `too_many_files`       | 400  | Zu viele Dateien in dieser Einsendung.                                    |
| `file_too_large`       | 413  | Eine hochgeladene Datei ist zu groß.                                      |
| `empty_file`           | 400  | Eine hochgeladene Datei war leer.                                         |
| `storage_cap_exceeded` | 413  | Das Speicherlimit dieses Kontos für Dateien wurde erreicht.               |
| `upgrade_required`     | 403  | Dieses Feature erfordert einen Pro-Plan.                                  |

## 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](/docs/de/reference/troubleshooting-faq) für die häufigsten
  Fälle, die auf Lösungen abgebildet sind.

<CardGroup cols={2}>
  <Card title="Optionsreferenz" icon="sliders" href="/docs/de/reference/options">
    Die reservierten Felder und die Formular-Konfiguration, auf die sich jeder Fehler bezieht.
  </Card>

  <Card title="Fehlerbehebung & FAQ" icon="circle-question" href="/docs/de/reference/troubleshooting-faq">
    Häufige Probleme, abgebildet auf die obigen Codes.
  </Card>
</CardGroup>