Doku:Antworten und Fehlercodes

Formulare

Antworten und Fehlercodes

Antworten der Mailiy-API und alle Fehlercodes mit HTTP-Status, etwa für Limits, Captcha und Datei-Uploads.

{ "success": true, "message": "Submission received.", "body": { "data": { "email": "…" }, "message": "Submission received." } }
    { "success": false, "code": "consent_required", "message": "…", "body": { "data": {}, "message": "…" } }

Das Feld body hat denselben Aufbau wie bei web3forms, bestehende Skripte laufen also weiter. Bei 429 steht im Header Retry-After, wie viele Sekunden du warten musst: 60 bei rate_limited (mehr als 5 Einsendungen pro Minute), bis zum Monatsersten bei limit_reached.

CodeHTTP
invalid_body400
origin_not_allowed403
api_key_required403
captcha_failed403
form_disabled403
invalid_access_key404
consent_required422
empty_submission422
file_rejected422
file_too_large413
storage_full413
limit_reached429
rate_limited429
delivery_failed500
scan_failed503

Ob Mailiy gerade normal arbeitet, zeigt die Statusseite. Für dein eigenes Monitoring gibt GET /api/status dasselbe als JSON zurück, ohne Schlüssel.