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 Zeechenemail(body, string, erforderlich)— Gëlteg E-Mail Adressmessage(body, string, erforderlich)— 103000 Zeechencompany(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_ERROR — D'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.