POST/api/public/contact
Nimmt eine Anfrage aus dem Kontaktformular der Zentor-App-Website entgegen und leitet sie an das Zentor-Team weiter.
Pflichtfelder sind `name` (2–120 Zeichen), `email` (gültige E-Mail-Adresse), `message` (10–3000 Zeichen) und `consentGiven`, das auf `true` gesetzt sein muss. Optional können `company`, `phone` und `topic` mitgesendet werden. Bei Erfolg antwortet der Server mit `{"ok":true}` und einer Bestätigungsmeldung. Fehlt ein Pflichtfeld, ist es ungültig oder fehlt die Einwilligung, antwortet der Endpunkt mit 400 `VALIDATION_ERROR`; das Feld `details` listet die einzelnen Fehler, sodass Sie die betroffenen Eingabefelder markieren können. Jede erfolgreiche Übermittlung legt eine neue Anfrage an. Sperren Sie die Senden-Schaltfläche deshalb bis zur Antwort und wiederholen Sie den Aufruf nicht automatisch. Höchstens 10 Anfragen je 15 Minuten pro IP-Adresse. Zusätzlich gelten die Zugriffsregeln von Zentor (IP-, Länder- und E-Mail-Domain-Regeln); abgelehnte Aufrufe erhalten 403.
Überblick
Aufruf: POST /api/public/contact. Der Endpunkt gehört zur Gruppe „Öffentliche Formulare“ der API von Zentor App. Er ist öffentlich erreichbar und benötigt keine Authentifizierung. Der Aufruf ist nicht idempotent: Jeder erfolgreiche Aufruf löst die Aktion erneut aus. Pflichtparameter: name (Body), email (Body), message (Body), consentGiven (Body). Optionale Parameter: company (Body), phone (Body), topic (Body). Dokumentierte Fehlerfälle: 400 VALIDATION_ERROR. Die Beispielantwort unten zeigt den Aufbau einer erfolgreichen Antwort im JSON-Format.
Auth & Absicherung
Keine Authentifizierung erforderlich
Idempotent: Nein
Parameter
name(body, string, erforderlich)— Name, 2–120 Zeichenemail(body, string, erforderlich)— Gültige E-Mail-Adressemessage(body, string, erforderlich)— Nachricht, 10–3000 Zeichencompany(body, string)— Firma (optional)phone(body, string)— Telefonnummer (optional)topic(body, string)— Thema der Anfrage (optional)consentGiven(body, boolean, erforderlich)— Datenschutzeinwilligung, muss `true` seinBeispiel-Request
{"name":"Max Mustermann","email":"max@example.com","message":"Ihre Nachricht (mind. 10 Zeichen).","consentGiven":true}Beispiel-Response
{"ok":true,"message":"Ihre Anfrage wurde übermittelt."}Fehlercodes
400 VALIDATION_ERROR — Ein Pflichtfeld fehlt oder ist ungültig, oder die Datenschutzeinwilligung fehlt. `details` enthält die einzelnen Fehlermeldungen.Geprüftes Verhalten
Vollständige Angaben liefern 200; fehlende Pflichtfelder oder eine fehlende Einwilligung liefern 400 `VALIDATION_ERROR`.
Öffentliche Formulare
POST /api/public/consultationNimmt eine Beratungsanfrage aus dem Formular der Zentor-App-Website entgegen.POST /api/public/access-requestReicht einen Zugangsantrag für ein Paket ein (Starter, Individuell oder 14-tägige Demo). Voraussetzung ist eine zuvor bestätigte E-Mail-Adresse.POST /api/public/access-request/email/start-verificationSendet einen sechsstelligen, 10 Minuten gültigen Bestätigungscode an die angegebene E-Mail-Adresse – der erste Schritt eines Zugangsantrags.POST /api/public/access-request/email/verifyPrüft den per E-Mail zugestellten Code und gibt ein Bestätigungstoken für den anschließenden Zugangsantrag aus.GET /api/public/access-request/payment-statusGibt an, welche Zahlungswege (PayPal, Stripe) für den Zugangsantrag aktuell verfügbar sind.GET /api/public/access-request/paypal/configLiefert die öffentliche PayPal-Konfiguration (aktiv, Modus, Währung) für den Bezahlschritt.POST /api/public/access-request/paypal/create-orderErstellt eine PayPal-Bestellung für das gewählte Paket.POST /api/public/access-request/paypal/capture-orderSchließt eine zuvor erstellte und vom Käufer im PayPal-Checkout freigegebene Bestellung ab (Capture). Den Betrag legt allein der Server fest.POST /api/public/access-request/stripe/create-checkoutErstellt eine Stripe-Checkout-Sitzung für das gewählte Paket.POST /api/public/activate-accountAktiviert ein neu angelegtes Benutzerkonto und setzt das erste Passwort – ausgelöst über den Link in der Einladungs-E-Mail.