POST/api/public/access-request/email/start-verification
Sendet einen sechsstelligen, 10 Minuten gültigen Bestätigungscode an die angegebene E-Mail-Adresse – der erste Schritt eines Zugangsantrags.
Senden Sie die zu bestätigende Adresse im Feld `email`. Die Antwort enthält `verification_id`, `expires_in_minutes` (10) und `resend_cooldown_seconds` (60). Verwenden Sie die `verification_id` zusammen mit derselben E-Mail-Adresse und dem empfangenen Code in `POST /api/public/access-request/email/verify`. Ein erneuter Versand ist erst nach Ablauf der Wartezeit möglich; zeigen Sie die verbleibende Zeit in Ihrer Oberfläche an. Wird das Limit überschritten, antwortet der Endpunkt mit 429 `RATE_LIMIT_EXCEEDED`. Kann die E-Mail nicht zugestellt werden, antwortet er mit 502 `MAIL_NOT_SENT`; prüfen Sie dann die Adresse und versuchen Sie es später erneut.
Überblick
Aufruf: POST /api/public/access-request/email/start-verification. 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: email (Body). Dokumentierte Fehlerfälle: 429 RATE_LIMIT_EXCEEDED, 502 MAIL_NOT_SENT. Die Beispielantwort unten zeigt den Aufbau einer erfolgreichen Antwort im JSON-Format.
Auth & Absicherung
Keine Authentifizierung erforderlich
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.
Rate-Limit: 10 Anfragen pro 15 Minuten (IP-basiert)
Idempotent: Nein
Parameter
email(body, string, erforderlich)— Zu bestätigende E-Mail-AdresseBeispiel-Request
{"email":"max@example.com"}Beispiel-Response
{"ok":true,"verification_id":"<UUID>","expires_in_minutes":10,"resend_cooldown_seconds":60}Fehlercodes
429 RATE_LIMIT_EXCEEDED — Zu viele Anfragen von dieser IP-Adresse. Warten Sie, bevor Sie einen neuen Code anfordern.502 MAIL_NOT_SENT — Der Bestätigungscode konnte nicht per E-Mail zugestellt werden.Geprüftes Verhalten
Der Aufruf liefert 200 mit `verification_id`, und der Code wird per E-Mail zugestellt; wiederholte Aufrufe liefern 429 `RATE_LIMIT_EXCEEDED`.
Ö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/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.