POST/api/public/consultation
Ontvangt een adviesaanvraag uit het formulier van de Zentor App-website.
Verplichte velden zijn `name` (2–120 tekens), `email` (geldig adres) en `consentGiven`, dat `true` moet zijn. Optioneel kunnen `company`, `phone` en `message` worden meegestuurd. Bij succes antwoordt de server met `{"ok":true}` en een bevestigingsbericht; het Zentor-team neemt daarna contact op. Ontbreekt een verplicht veld, is het ongeldig, of ontbreekt de toestemming, dan antwoordt het endpoint met 400 `VALIDATION_ERROR`. Elke succesvolle aanroep maakt een nieuwe aanvraag aan; de aanroep is dus niet idempotent. 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/consultation. 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), consentGiven (body). Optionele parameters: company (body), message (body), phone (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-mailadrescompany(body, string)— Bedrijf (optioneel)message(body, string)— Bericht (optioneel)phone(body, string)— Telefoonnummer (optioneel)consentGiven(body, boolean, vereist)— Privacytoestemming, moet `true` zijnVoorbeeld-request
{"name":"Max Mustermann","email":"max@example.com","company":"Musterfirma","message":"Aanvraag","consentGiven":true}Voorbeeld-response
{"ok":true,"message":"Uw adviesaanvraag is verzonden. Wij nemen spoedig contact met u op."}Foutcodes
400 VALIDATION_ERROR — Een verplicht veld ontbreekt of is ongeldig, of de toestemming ontbreekt.Geverifieerd gedrag
Volledige gegevens geven 200; ontbrekende of ongeldige gegevens geven 400 `VALIDATION_ERROR`.
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/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.