POST/api/public/contact
Ontvangt een aanvraag uit het contactformulier van de Zentor App-website en stuurt deze door naar het Zentor-team.
Verplichte velden zijn `name` (2–120 tekens), `email` (geldig e-mailadres), `message` (10–3000 tekens) en `consentGiven`, dat op `true` moet staan. Optioneel kunnen `company`, `phone` en `topic` worden meegestuurd. Bij succes antwoordt de server met `{"ok":true}` en een bevestigingsbericht. Ontbreekt een verplicht veld, is het ongeldig, of ontbreekt de toestemming, dan antwoordt het endpoint met 400 `VALIDATION_ERROR`; het veld `details` somt de afzonderlijke fouten op, zodat u de betreffende invoervelden kunt markeren. Elke succesvolle verzending maakt een nieuwe aanvraag aan. Zet de verzendknop daarom uit tot het antwoord binnen is en herhaal de aanroep 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/contact. 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), message (body), consentGiven (body). Optionele parameters: company (body), phone (body), topic (body). Gedocumenteerde foutgevallen: 400 VALIDATION_ERROR. 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)— Geldig e-mailadresmessage(body, string, vereist)— Bericht, 10–3000 tekenscompany(body, string)— Bedrijf (optioneel)phone(body, string)— Telefoonnummer (optioneel)topic(body, string)— Onderwerp van de aanvraag (optioneel)consentGiven(body, boolean, vereist)— Privacytoestemming, moet `true` zijnVoorbeeld-request
{"name":"Max Mustermann","email":"max@example.com","message":"Uw bericht (min. 10 tekens).","consentGiven":true}Voorbeeld-response
{"ok":true,"message":"Uw aanvraag is verzonden."}Foutcodes
400 VALIDATION_ERROR — Een verplicht veld ontbreekt of is ongeldig, of de privacytoestemming ontbreekt. `details` bevat de afzonderlijke foutmeldingen.Geverifieerd gedrag
Volledige gegevens geven 200; ontbrekende verplichte velden of ontbrekende toestemming geven 400 `VALIDATION_ERROR`.
Openbare formulieren
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/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.