POST/api/public/contact

A Zentor weboldal nyilvános kapcsolatfelvételi űrlapja. Létrehoz egy lekérdezést a belső lead-rendszerben.

A `POST /api/public/contact` végpont kezeli a Zentor weboldal nyilvános kapcsolatfelvételi űrlapját, és az igényt a belső lead-rendszerben tárolja. A végpont nem igényel dashboard-hitelesítést, és nem idempotens. Minden sikeres beküldés új leadet hozhat létre. Emiatt a frontend-nek a gombot az első kattintás után letiltania kell, és nem szabad automatikus ismétléseket indítania. A megerősített kötelező mezők a `name`, `email` és `message`. A név hossza 2 és 120 karakter között kell legyen, az e-mail-címnek érvényes formátumúnak kell lennie, az üzenetnek pedig meg kell felelnie a szerveroldali érvényességi szabályoknak. További mezőket csak akkor szabad elküldeni, ha azok szerepelnek a tényleges sémában. Az ismeretlen értékeket nem szabad használni a lead belső tulajdonságainak vezérlésére. Egy helyes űrlap ellenőrzi a kötelező mezőket a böngészőben, de nem kizárólag erre az ellenőrzésre támaszkodik. A szerver marad a mérvadó. Érvényességi hiba esetén a felületnek jelölnie kell a érintett mezőt, és meg kell őriznie a megadott tartalmakat. Egy általános sikerüzenet csak pozitív szerverválasz után jelenhet meg. A kapcsolatfelvételi űrlap nem biztonságos csatorna jelszavak, API-kulcsok, widget-tokenek, fizetési adatok vagy teljes ügyféladat-készletek továbbítására. A felhasználóknak meg kell adniuk az alkalmazási esetet, a érintett terméket és egy elérhető üzleti e-mail-címet. Műszaki probléma esetén a bérlő neve, az időpont, az érintett funkció és a reprodukálható lépések segítenek, anélkül, hogy felesleges személyes adatokat továbbítanának. Egy reális folyamat: a látogató kitölti a nevet, az e-mail-címet és az üzenetet, megerősíti az oldal adatvédelmi tájékoztatóját (ha szükséges), majd elküldi az űrlapot. A szerver érvényesíti az adatokat, létrehozza a leadet, és sikeres választ ad. Érvénytelen e-mail-cím vagy túl rövid név esetén nem jön létre teljes lead. A végpont nem hoz létre bérlőt, nem foglal le csomagot, és nem helyettesíti a strukturált termékbeállítást vagy a tanácsadási folyamatot. A spam és az automatizált sorozatkérések elleni védelem érdekében a kliensnek tiszteletben kell tartania a szerveroldali hibákat, és nem szabad azonnali végtelen hurokat indítania. Egy sikeres válasz esetén az űrlapmezőket csak akkor kell törölni, ha a szerver megerősítette az elfogadást. Ha a válasz elmarad, a felhasználó mentheti a tartalmat, és később ellenőrzött módon újra elküldheti azt. A belső hozzárendelés érdekében az üzenetnek a tényleges okot kell tartalmaznia, marketingi klisék vagy bizalmas mellékletek nélkül. Egyértelmű tárgy és precíz leírás csökkenti a visszakeresések számát. Az API azonban nem garantál prioritást, és nem erősít meg rögzített feldolgozási határidőt.

{"name":"Max Mustermann","email":"max@example.com","message":"Az Ön üzenete (min. 10 karakter).","consentGiven":true}

{"ok":true,"message":"A kérését elküldtük."}