POST/api/public/access-request/email/verify

Prüft den per E-Mail zugestellten Code und gibt ein Bestätigungstoken für den anschließenden Zugangsantrag aus.

Senden Sie `verification_id` (aus `start-verification`), dieselbe `email` und den sechsstelligen `code`. Bei Erfolg enthält die Antwort `verified: true` und ein `verification_token`, das Sie beim Einreichen des Zugangsantrags über `POST /api/public/access-request` mitsenden. Ein falscher oder abgelaufener Code, eine unpassende `verification_id` oder eine abweichende E-Mail-Adresse führen zu 400 `VERIFY_FAILED`. Fordern Sie in diesem Fall einen neuen Code an. Das Token gilt nur für diese E-Mail-Adresse und darf nicht in URLs oder Protokollen erscheinen. Höchstens 10 Anfragen je 15 Minuten pro IP-Adresse.

Überblick

Aufruf: POST /api/public/access-request/email/verify. 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: verification_id (Body), email (Body), code (Body). Dokumentierte Fehlerfälle: 400 VERIFY_FAILED. Die Beispielantwort unten zeigt den Aufbau einer erfolgreichen Antwort im JSON-Format.

Auth & Absicherung

Keine Authentifizierung erforderlich

Idempotent: Nein

Parameter

verification_id(body, string, erforderlich)— `verification_id` aus `start-verification`
email(body, string, erforderlich)— Dieselbe E-Mail-Adresse wie beim Anfordern des Codes
code(body, string, erforderlich)— Sechsstelliger Code aus der E-Mail

Beispiel-Request

{"verification_id":"<UUID>","email":"max@example.com","code":"123456"}

Beispiel-Response

{"ok":true,"verified":true,"verification_token":"<Token für den anschließenden Zugangsantrag>"}

Fehlercodes

400 VERIFY_FAILED — Code, `verification_id` oder E-Mail-Adresse sind falsch, oder der Code ist abgelaufen.

Geprüftes Verhalten

Ein falscher Code liefert 400 `VERIFY_FAILED`. Der Erfolgsfall entspricht der E-Mail-Bestätigung des Produktkonfigurators.

Öffentliche Formulare

POST /api/public/contactNimmt eine Anfrage aus dem Kontaktformular der Zentor-App-Website entgegen und leitet sie an das Zentor-Team weiter.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.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.

Verwandte Artikel

← Öffentliche Formulare