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.
| Code | HTTP |
|---|---|
invalid_body | 400 |
origin_not_allowed | 403 |
api_key_required | 403 |
captcha_failed | 403 |
form_disabled | 403 |
invalid_access_key | 404 |
consent_required | 422 |
empty_submission | 422 |
file_rejected | 422 |
file_too_large | 413 |
storage_full | 413 |
limit_reached | 429 |
rate_limited | 429 |
delivery_failed | 500 |
scan_failed | 503 |
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.