POST/api/public/access-request

Reicht einen Zugangsantrag für ein Paket ein (Starter, Individuell oder 14-tägige Demo). Voraussetzung ist eine zuvor bestätigte E-Mail-Adresse.

Bestätigen Sie zuerst die E-Mail-Adresse über `POST /api/public/access-request/email/start-verification` und `POST /api/public/access-request/email/verify`. Senden Sie dann `name`, dieselbe `email`, das Paket `package` (`starter`, `individual` oder `demo_access`) und das erhaltene `verification_token`. Optional sind `company`, `phone`, `companyWebsite`, `paymentMethod` (`paypal`, `kreditkarte`, `rechnung`, `stripe_card` oder `stripe_sepa`), `wish` (`trial`, `subscription` oder `offer`; beim Demo-Zugang immer `trial`) und `message`. Ohne gültige Bestätigung antwortet der Server mit 400 `EMAIL_NOT_VERIFIED`. Fehlende Pflichtfelder oder ungültige Werte für Paket, Zahlungsart oder Wunsch führen zu 400 `VALIDATION_ERROR`. Jeder erfolgreiche Antrag wird neu angelegt und von Zentor bearbeitet; wiederholen Sie den Aufruf daher 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/access-request. 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), package (Body). Optionale Parameter: company (Body), phone (Body), companyWebsite (Body), paymentMethod (Body), wish (Body), message (Body). Dokumentierte Fehlerfälle: 400 VALIDATION_ERROR, 400 EMAIL_NOT_VERIFIED. 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 Zeichen
email(body, string, erforderlich)— E-Mail-Adresse, die zuvor über `/email/verify` bestätigt wurde
package(body, string, erforderlich)— Paket: `starter`, `individual` oder `demo_access`
company(body, string)— Firma, max. 160 Zeichen (optional)
phone(body, string)— Telefonnummer, max. 40 Zeichen (optional)
companyWebsite(body, string)— Website des Unternehmens, max. 200 Zeichen (optional)
paymentMethod(body, string)— Zahlungsart: `paypal`, `kreditkarte`, `rechnung`, `stripe_card` oder `stripe_sepa` (optional)
wish(body, string)— Wunsch: `trial`, `subscription` oder `offer`; bei `demo_access` immer `trial` (optional)
message(body, string)— Nachricht, max. 3000 Zeichen (optional)

Beispiel-Request

{"name":"Max Mustermann","email":"max@example.com","package":"demo_access"}

Beispiel-Response

{"ok":false,"error":"EMAIL_NOT_VERIFIED","message":"Bitte bestätigen Sie zuerst Ihre E-Mail-Adresse."}

Fehlercodes

400 VALIDATION_ERROR — Ein Pflichtfeld fehlt, oder Paket, Zahlungsart oder Wunsch sind ungültig.
400 EMAIL_NOT_VERIFIED — Die E-Mail-Adresse wurde nicht zuvor über `/email/start-verification` und `/email/verify` bestätigt, oder das `verification_token` fehlt bzw. ist ungültig.

Geprüftes Verhalten

Ein leerer Body liefert 400 `VALIDATION_ERROR`; gültige Daten ohne bestätigte E-Mail-Adresse liefern 400 `EMAIL_NOT_VERIFIED`. Der Erfolgsfall folgt nach der E-Mail-Bestätigung dem dokumentierten Ablauf.

Ö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-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.

Verwandte Artikel

← Öffentliche Formulare