POST/api/public/access-request/email/start-verification

Stuurt een zescijferige bevestigingscode, 10 minuten geldig, naar het opgegeven e-mailadres — de eerste stap van een toegangsaanvraag.

Stuur het te bevestigen adres in het veld `email`. Het antwoord bevat `verification_id`, `expires_in_minutes` (10) en `resend_cooldown_seconds` (60). Gebruik `verification_id` samen met hetzelfde e-mailadres en de ontvangen code in `POST /api/public/access-request/email/verify`. Een nieuwe code kan pas worden verzonden na afloop van de wachttijd; toon de resterende tijd in uw interface. Wordt de limiet overschreden, dan antwoordt het endpoint met 429 `RATE_LIMIT_EXCEEDED`. Kan de e-mail niet worden afgeleverd, dan antwoordt het met 502 `MAIL_NOT_SENT`; controleer dan het adres en probeer het later opnieuw.

Overzicht

Aanroep: POST /api/public/access-request/email/start-verification. 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: email (body). Gedocumenteerde foutgevallen: 429 RATE_LIMIT_EXCEEDED, 502 MAIL_NOT_SENT. Het voorbeeldantwoord hieronder toont de opbouw van een geslaagd antwoord in JSON-formaat.

Auth & beveiliging

Geen authenticatie vereist

Maximaal 10 aanvragen per 15 minuten per IP-adres. Daarnaast gelden de toegangsregels van Zentor (IP-, land- en e-maildomeinregels); geweigerde aanroepen krijgen 403.

Rate-limit: 10 Anfragen pro 15 Minuten (IP-basiert)

Idempotent: Nee

Parameters

email(body, string, vereist)— Te bevestigen e-mailadres

Voorbeeld-request

{"email":"max@example.com"}

Voorbeeld-response

{"ok":true,"verification_id":"<UUID>","expires_in_minutes":10,"resend_cooldown_seconds":60}

Foutcodes

429 RATE_LIMIT_EXCEEDED — Te veel aanvragen vanaf dit IP-adres. Wacht voordat u een nieuwe code aanvraagt.
502 MAIL_NOT_SENT — De bevestigingscode kon niet per e-mail worden afgeleverd.

Geverifieerd gedrag

De aanroep geeft 200 met een `verification_id`, en de code wordt per e-mail verzonden; herhaalde aanroepen geven 429 `RATE_LIMIT_EXCEEDED`.

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-requestDient een toegangsaanvraag in voor een pakket (Starter, Individueel of 14-daagse demo). Een vooraf bevestigd e-mailadres is vereist.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.

Gerelateerde artikelen

← Openbare formulieren