POST/api/public/contact

Verejný kontaktný formulár Zentor-webovej stránky. Vytvára požiadavku vo vnútornom systéme leadov.

`POST /api/public/contact` spracuje verejné kontaktné formulár Zentor-webovej stránky a uloží požiadavku do vnútorného systému pre potenciálnych zákazníkov. Tento koncový bod nevyžaduje overenie prihlásením do dashboardu a nie je idempotentný. Každé úspešné odoslanie môže vytvoriť nového potenciálneho zákazníka. Preto by malo frontendové rozhranie po prvom kliknutí deaktivovať tlačidlo Odoslať a nespúšťať žiadne automatické opakovania. Potvrdené povinné polia zahŕňajú `name`, `email` a `message`. Meno musí mať dĺžku medzi 2 a 120 znakmi, e-mailová adresa musí mať platný formát a správa musí spĺňať serverové pravidlá overovania. Ďalšie polia sa môžu odoslať len vtedy, ak sú v skutočnom schéme predpísané. Neznáme hodnoty by sa nemali používať na ovládanie vnútorných vlastností potenciálneho zákazníka. Správne formulár overuje povinné polia už v prehliadači, ale neopiera sa výlučne o túto kontrolu. Server zostáva rozhodujúci. Pri chybe overenia by malo rozhranie označiť dotknuté pole a zachovať zadané údaje. Všeobecná správa o úspechu sa môže objaviť až po kladnej odpovedi servera. Kontaktné formulár nie je bezpečným kanálom pre heslá, API kľúče, tokeny widgetov, platobné údaje alebo kompletné súbory údajov zákazníka. Používatelia by mali uviesť prípad použitia, dotknuté produkt a dostupnú obchodnú e-mailovú adresu. Pri technických problémoch pomáhajú názov tenanta, čas, dotknutá funkcia a opakovateľné kroky bez zbytočného prenosu osobných údajov. Realistický postup: Návštevník vyplní meno, e-mail a správu, prípadne potvrdí upozornenia stránky o ochrane osobných údajov a odošle formulár. Server overí údaje, vytvorí potenciálneho zákazníka a vráti úspešnú odpoveď. Pri neplatnom e-maili alebo príliš krátkom mene sa nevytvorí kompletný potenciálny zákazník. Koncový bod nevytvára žiadneho tenanta, neúčtuje žiadny balík a nenahrádza štruktúrovanú konfiguráciu produktu ani poradenský proces. Na ochranu pred spamom a automatizovanými sériovými požiadavkami by mal klient rešpektovať chyby servera a nezačínať okamžité nekonečné slučky. Úspešná odpoveď by mala vyčistiť vstupné polia až po potvrdení prijatia serverom. Ak odpoveď nevyjde, môže si používateľ uložiť obsah a neskôr odošlať znova po kontrole. Pre vnútorné priradenie by mala správa obsahovať skutočný dôvod bez marketingových frázy alebo dôverných príloh. Jasné predmet a presný popis problému znižujú spätné otázky. API však nepriraduje žiadnu garantovanú prioritu ani nepotvrdzuje pevnú lehotu na vybavenie.

{"name":"Max Mustermann","email":"max@example.com","message":"Vaša správa (min. 10 znakov).","consentGiven":true}

{"ok":true,"message":"Vaša požiadavka bola odoslaná."}