POST/api/public/contact

Zentor-verkkosivuston julkinen yhteydenottolomake. Luo pyynnön sisäiseen liidijärjestelmään.

`POST /api/public/contact` käsittelee Zentorin verkkosivuston julkista yhteydenottolomaketta ja tallentaa pyynnön sisäiseen liidijärjestelmään. Päätepiste ei vaadi kojelautatunnistautumista, eikä se ole idempotentti. Jokainen onnistunut lähetys voi luoda uuden liidin. Käyttöliittymän tulisi siksi poistaa "Lähetä"-painikkeen toiminnallisuus ensimmäisen klikkauksen jälkeen eikä aiheuttaa automaattisia toistoja. Vahvistettuihin pakollisiin kenttiin kuuluvat `name`, `email` ja `message`. Nimen on oltava 2–120 merkkiä pitkä, sähköpostiosoitteen on oltava kelvollinen muoto, ja viestin on täytettävä palvelinpuolen validointisäännöt. Muita kenttiä saa lähettää vain, jos ne ovat määriteltyjä varsinaisessa skeemassa. Tuntemattomia arvoja ei tule käyttää liidin sisäisten ominaisuuksien ohjaamiseen. Oikein toimiva lomake tarkistaa pakolliset kentät jo selaimessa, mutta ei luota pelkästään tähän tarkistukseen. Palvelin on edelleen ensisijainen. Validointivirheen sattuessa käyttöliittymän tulisi merkitä kyseinen kenttä ja säilyttää syötetyt tiedot. Yleinen onnistumisviesti saa näkyä vasta positiivisen palvelinvastauksen jälkeen. Yhteydenottolomake ei ole turvallinen kanava salasanoille, API-avaimille, widget-tunnisteille, maksutiedoille tai kokonaisille asiakastietueille. Käyttäjien tulisi ilmoittaa käyttötarkoitus, kyseinen tuote sekä toimiva yrityssähköpostiosoite. Teknisen ongelman sattuessa tenant-nimi, ajankohta, kyseinen toiminto ja toistettavat vaiheet auttavat, ilman tarpeettomia henkilötietoja. Tyypillinen prosessi: Käyttäjä täyttää nimen, sähköpostin ja viestin, hyväksyy mahdollisesti sivuston tietosuojaselosteen ja lähettää lomakkeen. Palvelin validoi tiedot, luo liidin ja palauttaa onnistumisvastauksen. Virheellisellä sähköpostiosoitteella tai liian lyhyellä nimellä ei luoda täydellistä liidiä. Päätepiste ei luo tenanttia, varaa pakettia tai korvaa strukturoitua tuotekonfiguraatiota tai konsultointiprosessia. Roskapostin ja automatisoitujen sarjapyyntöjen estämiseksi asiakasohjelmiston tulisi kunnioittaa palvelinpuolen virheitä eikä aloittaa välittömiä loputtomia silmukoita. Onnistuneen vastauksen jälkeen syöttökentät tyhjennetään vasta, kun palvelin on vahvistanut tämän. Jos vastausta ei tule, käyttäjä voi tallentaa sisällön ja lähettää sen myöhemmin hallitusti uudelleen. Sisäistä kohdistusta varten viestin tulisi sisältää todellinen syy, ilman markkinointikielteitä tai luottamuksellisia liitteitä. Selkeä aihe ja tarkka ongelman kuvaus vähentävät lisäkysymyksiä. API ei kuitenkaan myönnä taattua prioriteettia eikä vahvista kiinteää käsittelyaikaa.

{"name":"Max Mustermann","email":"max@example.com","message":"Viestinne (vähintään 10 merkkiä).","consentGiven":true}

{"ok":true,"message":"Pyyntösi on vastaanotettu."}