POST/api/public/contact

Offentligt kontaktformular på Zentor-webstedet. Opretter en forespørgsel i det interne lead-system.

`POST /api/public/contact` behandler det offentlige kontaktformular på Zentor-webstedet og gemmer forespørgslen i det interne lead-system. Endepunktet kræver ikke dashboard-godkendelse og er ikke idempotent. Hver vellykket indsendelse kan oprette en ny lead. Frontend bør derfor deaktivere send-knappen efter første klik og ikke udløse automatiske gentagelser. De bekræftede obligatoriske felter omfatter `name`, `email` og `message`. Navnet skal være mellem 2 og 120 tegn langt, e-mail-adressen skal have et gyldigt format, og beskeden skal opfylde de server-side valideringsregler. Yderligere felter må kun sendes, hvis de er inkluderet i det faktiske skema. Ukendte værdier bør ikke bruges til at styre interne egenskaber for leadet. Et korrekt formular tjekker de obligatoriske felter allerede i browseren, men stoler ikke udelukkende på denne kontrol. Serveren forbliver afgørende. Ved en valideringsfejl skal brugergrænsefladen markere det pågældende felt og bevare de indtastede indhold. En generisk succesmeddelelse må først vises efter en positiv serverrespons. Kontaktformularen er ikke en sikker kanal til adgangskoder, API-nøgler, widget-tokens, betalingsoplysninger eller komplette kundeposter. Brugere bør angive use casen, det berørte produkt og en nåbar forretningsmæssig e-mailadresse. Ved et teknisk problem hjælper tenant-navn, tidspunkt, berørt funktion og reproducerbare trin, uden at overføre unødvendigt personligt indhold. En realistisk forløb: Besøgende udfylder navn, e-mail og besked, bekræfter eventuelt sidens databeskyttelsesoplysninger og sender formularen. Serveren validerer dataene, opretter leadet og returnerer et succesfuldt svar. Ved ugyldig e-mail eller for kort navn oprettes der ikke et fuldstændigt lead. Endepunktet opretter ikke en tenant, booker ikke en pakke og erstatter ikke den strukturerede produktkonfiguration eller rådgivningsprocessen. For at beskytte mod spam og automatiserede serieanmodninger bør klienten respektere serverens fejl og ikke starte uendelige sløjfer med det samme. En vellykket besvarelse bør først tømme inputfelterne, når serveren har bekræftet modtagelsen. Hvis svaret udebliver, kan brugeren gemme indholdet og senere sende det igen på kontrolleret vis. Til intern henføring bør beskeden indeholde den faktiske anledning, uden marketingfloskler eller fortrolige vedhæftninger. En klar emnelinje og en præcis problembeskrivelse reducerer opfølgende spørgsmål. API'en tildeler dog ikke en garanteret prioritet og bekræfter ingen fast behandlingsfrist.

Auth & Absicherung

Keine Authentifizierung erforderlich

Idempotent: Nein

Parameter

name(body, string, erforderlich)2–120 tegn
email(body, string, erforderlich)Gyldig e-mailadresse
message(body, string, erforderlich)10–3000 tegn
company(body, string)
phone(body, string)
topic(body, string)
consentGiven(body, boolean, erforderlich)Skal være true (databeskyttelsessamtykke)

Beispiel-Request

{"name":"Max Mustermann","email":"max@example.com","message":"Din besked (min. 10 tegn).","consentGiven":true}

Beispiel-Response

{"ok":true,"message":"Din anmodning er blevet sendt."}

Fehlercodes

400 VALIDATION_ERRORObligatorisk felt mangler/ugyldigt, eller databeskyttelsessamtykke mangler (detaljearray med individuelle fejlmeddelelser).

Live-Test-Nachweis

Succes (200) og negativt tilfælde (400, manglende felter inkl. manglende samtykke) live verificeret.

Offentlige formularer