POST/api/public/contact

Publieke kontakvorm van die Zentor-webwerf. Skep 'n versoek in die interne Lead-stelsel.

`POST /api/public/contact` verwerk die publieke kontakvorm en kan 'n nuwe Lead skep. Die endpoint vereis geen Dashboard-auth nie en is nie idempotent nie; die UI behoort dubbele submits te voorkom. Bevestigde verpligte velde sluit `name`, `email` en `message` in, plus die vereiste toestemming waar die schema dit afdwing. Naam moet 2–120 karakters hê, e-pos geldig wees en die boodskap aan die validasiereëls voldoen. Client-validasie is nuttig maar die server bly autoritatief. By validasiefoute moet die betrokke veld duidelik gewys word. Die kontakvorm is nie 'n veilige kanaal vir wagwoorde, API Keys, Widget Tokens of betalingsdata nie. 'n Suksesvolle respons bevestig dat die versoek aanvaar is; dit skep nie outomaties 'n Tenant, pakket of betaling nie.

Verifikasie en sekuriteit

Geen verifikasie vereis nie

Idempotent: Nee

Parameters

name(body, string, vereis)— 2–120 karakters
email(body, string, vereis)— Geldige e-posadres
message(body, string, vereis)— 10–3000 karakters
company(body, string)
phone(body, string)
topic(body, string)
consentGiven(body, boolean, vereis)— Moet true wees (privaatheidstoestemming)

Voorbeeldversoek

{"name":"Max Mustermann","email":"max@example.com","message":"Jou boodskap (min. 10 karakters).","consentGiven":true}

Voorbeeldrespons

{"ok":true,"message":"Ihre Anfrage wurde übermittelt."}

Foutkodes

400 VALIDATION_ERROR — Verpligte veld ontbreek/ongeldig of privaatheidstoestemming ontbreek; details bevat die veldfoute.

Bewys van live-toets

Sukses (200) en negatiewe geval (400, ontbrekende velde/toestemming) live geverifieer.

← Openbare vorms