POST/api/public/access-request
Dient een toegangsaanvraag in voor een pakket (Starter, Individueel of 14-daagse demo). Een vooraf bevestigd e-mailadres is vereist.
Bevestig eerst het e-mailadres via `POST /api/public/access-request/email/start-verification` en `POST /api/public/access-request/email/verify`. Stuur daarna `name`, hetzelfde `email`, het pakket `package` (`starter`, `individual` of `demo_access`) en het ontvangen `verification_token`. Optioneel kunnen `company`, `phone`, `companyWebsite`, `paymentMethod` (`paypal`, `kreditkarte`, `rechnung`, `stripe_card` of `stripe_sepa`), `wish` (`trial`, `subscription` of `offer`; bij demotoegang altijd `trial`) en `message` worden meegestuurd. Zonder geldige bevestiging antwoordt de server met 400 `EMAIL_NOT_VERIFIED`. Ontbrekende verplichte velden of ongeldige waarden voor pakket, betaalmethode of wens leiden tot 400 `VALIDATION_ERROR`. Elke succesvolle aanvraag wordt als nieuwe aanvraag aangemaakt en door Zentor verwerkt; herhaal de aanroep dus niet automatisch. Maximaal 10 aanvragen per 15 minuten per IP-adres. Daarnaast gelden de toegangsregels van Zentor (IP-, land- en e-maildomeinregels); geweigerde aanroepen krijgen 403.
Overzicht
Aanroep: POST /api/public/access-request. Dit endpoint hoort bij de groep ‘Openbare formulieren’ van de API van Zentor App. Het is openbaar toegankelijk en vereist geen authenticatie. De aanroep is niet idempotent: elke geslaagde aanroep activeert de actie opnieuw. Verplichte parameters: name (body), email (body), package (body). Optionele parameters: company (body), phone (body), companyWebsite (body), paymentMethod (body), wish (body), message (body). Gedocumenteerde foutgevallen: 400 VALIDATION_ERROR, 400 EMAIL_NOT_VERIFIED. Het voorbeeldantwoord hieronder toont de opbouw van een geslaagd antwoord in JSON-formaat.
Auth & beveiliging
Geen authenticatie vereist
Idempotent: Nee
Parameters
name(body, string, vereist)— Naam, 2–120 tekensemail(body, string, vereist)— E-mailadres dat eerder is bevestigd via `/email/verify`package(body, string, vereist)— Pakket: `starter`, `individual` of `demo_access`company(body, string)— Bedrijf, max. 160 tekens (optioneel)phone(body, string)— Telefoonnummer, max. 40 tekens (optioneel)companyWebsite(body, string)— Website van het bedrijf, max. 200 tekens (optioneel)paymentMethod(body, string)— Betaalmethode: `paypal`, `kreditkarte`, `rechnung`, `stripe_card` of `stripe_sepa` (optioneel)wish(body, string)— Wens: `trial`, `subscription` of `offer`; bij `demo_access` altijd `trial` (optioneel)message(body, string)— Bericht, max. 3000 tekens (optioneel)Voorbeeld-request
{"name":"Jan Jansen","email":"max@example.com","package":"demo_access"}Voorbeeld-response
{"ok":false,"error":"EMAIL_NOT_VERIFIED","message":"Bevestig eerst uw e-mailadres."}Foutcodes
400 VALIDATION_ERROR — Een verplicht veld ontbreekt, of pakket, betaalmethode of wens zijn ongeldig.400 EMAIL_NOT_VERIFIED — Het e-mailadres is niet eerder bevestigd via `/email/start-verification` en `/email/verify`, of het `verification_token` ontbreekt of is ongeldig.Geverifieerd gedrag
Een lege body geeft 400 `VALIDATION_ERROR`; geldige gegevens zonder bevestigd e-mailadres geven 400 `EMAIL_NOT_VERIFIED`. Het succesgeval volgt het gedocumenteerde verloop na de e-mailbevestiging.
Openbare formulieren
POST /api/public/contactOntvangt een aanvraag uit het contactformulier van de Zentor App-website en stuurt deze door naar het Zentor-team.POST /api/public/consultationOntvangt een adviesaanvraag uit het formulier van de Zentor App-website.POST /api/public/access-request/email/start-verificationStuurt een zescijferige bevestigingscode, 10 minuten geldig, naar het opgegeven e-mailadres — de eerste stap van een toegangsaanvraag.POST /api/public/access-request/email/verifyControleert de per e-mail verzonden code en geeft een bevestigingstoken af voor de daaropvolgende toegangsaanvraag.GET /api/public/access-request/payment-statusGeeft aan welke betaalmethoden (PayPal, Stripe) momenteel beschikbaar zijn voor de toegangsaanvraag.GET /api/public/access-request/paypal/configGeeft de publieke PayPal-configuratie (actief, modus, valuta) voor de betaalstap.POST /api/public/access-request/paypal/create-orderMaakt een PayPal-bestelling aan voor het gekozen pakket.POST /api/public/access-request/paypal/capture-orderRondt een eerder aangemaakte en door de koper in de PayPal-checkout goedgekeurde bestelling af (capture). Het bedrag wordt uitsluitend door de server vastgesteld.POST /api/public/access-request/stripe/create-checkoutMaakt een Stripe-checkoutsessie aan voor het gekozen pakket.POST /api/public/activate-accountActiveert een nieuw aangemaakt gebruikersaccount en stelt het eerste wachtwoord in — geactiveerd via de link in de uitnodigingse-mail.