POST/api/public/contact

Openbaar contactformulier van de Zentor-website. Maakt een aanvraag in het interne lead-systeem.

`POST /api/public/contact` verwerkt het openbare contactformulier van de Zentor-website en legt de aanvraag vast in het interne leadsysteem. Het endpoint vereist geen dashboardauthenticatie en is niet idempotent. Elke succesvolle verzending kan een nieuwe lead genereren. De frontend moet de verzendknop daarom na de eerste klik uitschakelen en geen automatische herhalingen uitlokken. Tot de bevestigde verplichte velden behoren `name`, `email` en `message`. De naam moet tussen 2 en 120 tekens lang zijn, het e-mailadres moet een geldig formaat hebben, en het bericht moet voldoen aan de serverzijdige validatieregels. Aanvullende velden mogen alleen worden verzonden als ze in het daadwerkelijke schema zijn voorzien. Onbekende waarden mogen niet worden gebruikt om interne eigenschappen van de lead te sturen. Een correct formulier controleert de verplichte velden al in de browser, maar vertrouwt niet uitsluitend op deze controle. De server blijft bepalend. Bij een validatiefout moet de interface het betrokken veld markeren en de ingevoerde inhoud behouden. Een algemene succesmelding mag pas verschijnen na een positief antwoord van de server. Het contactformulier is geen veilig kanaal voor wachtwoorden, API-sleutels, widget-tokens, betalingsgegevens of volledige klantgegevens. Gebruikers moeten de toepassing, het betrokken product en een bereikbaar zakelijk e-mailadres opgeven. Bij een technisch probleem helpen tenantnaam, tijdstip, betrokken functie en reproduceerbare stappen, zonder onnodige persoonsgegevens over te dragen. Een realistisch verloop: de bezoeker vult naam, e-mail en bericht in, bevestigt eventueel de privacyinformatie van de pagina en verzendt het formulier. De server valideert de gegevens, maakt de lead aan en levert een succesantwoord. Bij een ongeldig e-mailadres of een te korte naam wordt geen volledige lead aangemaakt. Het endpoint maakt geen tenant aan, boekt geen pakket en vervangt niet de gestructureerde productconfiguratie of het adviestraject. Ter bescherming tegen spam en geautomatiseerde massa-aanvragen moet de client de foutmeldingen van de server respecteren en geen directe oneindige lussen starten. Bij een succesvol antwoord mogen de invoervelden pas worden leeggemaakt wanneer de server de ontvangst heeft bevestigd. Blijft het antwoord uit, dan kan de gebruiker de inhoud veiligstellen en later gecontroleerd opnieuw verzenden. Voor de interne toewijzing moet het bericht de daadwerkelijke aanleiding bevatten, zonder marketingfrasen of vertrouwelijke bijlagen. Een duidelijk onderwerp en een precieze probleembeschrijving beperken het aantal vervolgvragen. De API zelf kent echter geen gegarandeerde prioriteit toe en bevestigt geen vaste afhandelingstermijn.

{"name":"Max Mustermann","email":"max@example.com","message":"Uw bericht (min. 10 tekens).","consentGiven":true}

{"ok":true,"message":"Uw aanvraag is verzonden."}