POST/api/public/contact

Javni kontaktni obrazac web stranice Zentor. Kreira zahtjev u internom sustavu za generiranje potencijalnih klijenata.

`POST /api/public/contact` obrađuje javni kontaktni obrazac web stranice Zentor i sprema zahtjev u interni sustav za generiranje potencijalnih klijenata. Krajnja točka ne zahtijeva autentifikaciju putem nadzorne ploče i nije idempotentna. Svaki uspješan unos može generirati novog potencijalnog klijenta. Frontend bi trebao onemogućiti gumb za slanje nakon prvog klika i ne smije pokretati automatske ponovne pokretanja. Potvrđeni obavezni polja su `name`, `email` i `message`. Ime mora biti između 2 i 120 znakova, e-mail adresa mora biti u valjanom formatu, a poruka mora ispunjavati pravila validacije na serveru. Ostala polja smiju se slati samo ako su predviđena u stvarnom shemi. Nepoznate vrijednosti ne bi trebalo koristiti za kontrolu internih svojstava potencijalnog klijenta. Ispravan obrazac provjerava obavezna polja već u pregledniku, ali ne oslanja se isključivo na tu provjeru. Server ostaje ključan. U slučaju greške validacije, sučelje bi trebalo označiti pogođeno polje i zadržati unesene podatke. Generička poruka o uspjehu smije se prikazati tek nakon pozitivnog odgovora servera. Kontaktni obrazac nije siguran kanal za lozinke, API ključeve, widget tokene, podatke o plaćanju ili cjelovite podatke o korisnicima. Korisnici bi trebali navesti svrhu, pogođeni proizvod i dostupnu poslovnu e-mail adresu. U slučaju tehničkog problema, korisno je navesti naziv tenanta, vrijeme, pogođenu funkciju i ponovljive korake, bez prenošenja nepotrebnih osobnih podataka. Realističan tijek: Posjetitelj popunjava ime, e-mail i poruku, eventualno potvrđuje obavijesti o zaštiti podataka stranice i šalje obrazac. Server validira podatke, kreira potencijalnog klijenta i šalje odgovor o uspjehu. Ako je e-mail adresa nevaljana ili je ime previše kratko, neće se kreirati cjeloviti potencijalni klijent. Krajnja točka ne kreira tenanta, ne rezervira paket i ne zamjenjuje strukturiranu konfiguraciju proizvoda ili proces savjetovanja. Za zaštitu od neželjene pošte i automatiziranih serijskih upita, klijent bi trebao poštivati greške na strani servera i ne pokretati trenutne beskonačne petlje. Uspješan odgovor bi trebao očistiti polja za unos tek nakon što server potvrdi prihvat. Ako nema odgovora, korisnik može spremiti sadržaj i kasnije ga ponovno poslati pod kontrolom. Za internu dodjelu, poruka bi trebala sadržavati stvarnu svrhu, bez marketinških fraza ili povjerljivih priloga. Jasna naslovna linija i precizna opisa problema smanjuju pitanja. API sam ne dodjeljuje jamčenu prioritet i ne potvrđuje fiksni rok obrade.

{"name":"Max Mustermann","email":"max@example.com","message":"Vaša poruka (minimum 10 znakova).","consentGiven":true}

{"ok":true,"message":"Vaš zahtjev je poslan."}