POST/api/public/contact

Public Kontaktformular vun der Zentor Websäit.

`POST /api/public/contact` verschaaft dat ëffentlecht Kontaktformulaire vun der Zentor-Websäit a leet d'Ufro am internen Lead-System of. Den Endpunkt brauch keng Dashboard-Authentifizéierung an ass net idempotent. All erfollegräich Iwwermëttlung kann en neie Lead erstellen. D'Frontend sollt de Send-Knäppchen dofir no dem éischte Klick deaktivéieren a keng automatesch Widderhuelungen auslösen. Zu de bestätegten Flichtfelder gehéieren `name`, `email` a `message`. Den Numm muss tëscht 2 an 120 Zeechen laang sinn, d'E-Mail-Adress muss e valabelt Format hunn, an d'Message muss déi serverséiteg Validéierungsreegele erfëllen. Weider Felder dierfen nëmme geschéckt ginn, wa se am tatsächlechen Schema virgesinn sinn. Onbekannte Wäerter sollten net benotzt ginn, fir intern Eegeschaften vum Lead ze steieren. E korrekt Formulaire préift déi Flichtfelder schonn am Browser, verléisst sech awer net exklusiv op dës Préiwung. De Server bleift moossgebend. Bei engem Validéierungsfeeler sollt d'Uewerfläch dat betraffent Feld markéieren an déi ageginn Inhalter erhalen. Eng generesch Erfollegsmeldung dierf éischt no enger positiver Serveräntwert erschéngen. D'Kontaktformulaire ass kee sécheren Kanal fir Passwierder, API-Schlësselen, Widget-Tokens, Bezuelungsdaten oder komplett Kundedatesätz. Benotzer sollten den Undwendungsfall, dat betraffent Produkt an eng erreechbar geschäftlech E-Mail-Adress uginn. Bei engem technesche Problem hëllefen Tenant-Numm, Zäitpunkt, betraffe Funktioun a reproduzéierbar Schrëtt, ouni onnéideg perséinlechbezunn Inhalter z'iwwerdroen. En realisteschen Oflaf: Den Besicher fëllt Numm, E-Mail a Message aus, bestätegt evtl. déi Datenschutzhiweiser vun der Säit a schéckt d'Formulaire. De Server valideiert d'Daten, leet de Lead un a liwwert eng Erfollegsäntwert. Bei ongülteger E-Mail oder ze kuerzem Numm gëtt kee komplette Lead erstallt. Den Endpunkt erstellt keen Tenant, bucht kee Pak an ersetzt net déi strukturéiert Produktkonfiguratioun oder de Berodungsprozess. Zum Schutz virun Spam an automatiséierten Seriëufroen sollt de Client déi serverséiteg Feeler respektéieren a keng direkt Endlosschleefen starten. Eng erfollegräich Äntwert sollt d'Ingabsfelder éischt dann eidel maachen, wann de Server d'Ugoen bestätegt huet. Bleift déi Äntwert aus, kann de Benotzer den Inhalt sécheren a méi spéit kontrolléiert nach eng Kéier schécken. Fir déi intern Zouornung sollt d'Message den tatsächlechen Uloss enthalen, ouni Marketingfloskelen oder vertraulech Uhänger. E klore Betreff an eng präzis Problembeschreiwung reduzéieren Réckfroen. D'API selwer vergëtt awer keng garantéiert Prioritéit a bestätegt keng fest Bearbechtungsfrist.

Auth & Absicherung

Keine Authentifizierung erforderlich

Idempotent: Nein

Parameter

name(body, string, erforderlich)2120 Zeechen
email(body, string, erforderlich)Gëlteg E-Mail Adress
message(body, string, erforderlich)103000 Zeechen
company(body, string)
phone(body, string)
topic(body, string)
consentGiven(body, boolean, erforderlich)Muss richteg sinn (Datenschutzvertrag)

Beispiel-Request

{"name":"Max Mustermann","email":"max@example.com","message":"Ihre Nachricht (mind. 10 Zeichen).","consentGiven":true}

Beispiel-Response

{"ok":true,"message":"Är Ufro gouf iwwerdroen"}

Fehlercodes

400 VALIDATION_ERRORD'Zwangsfeld ass net verfügbar/ongëlteg, oder d'Datenschutz-Anerkennung ass net verfügbar (Detailerarray mat eenzelne Feelermeldungen).

Live-Test-Nachweis

Erfolleg (200) an Negativ (400, fehlende Felder inklusiv fehlende Zoustëmmung) live verifizéiert.

Ëffentlech Formulairen