POST/api/public/contact

Pampublikong form para sa pakikipag-ugnayan sa website ng Zentor. Lumilikha ito ng isang kahilingan sa panloob na sistema ng lead.

`POST /api/public/contact` ay nagpoproseso ng pampublikong contact form ng website ng Zentor at nagtatala ng kahilingan sa internal na lead system. Ang endpoint na ito ay hindi nangangailangan ng authentication sa dashboard at hindi idempotent. Ang bawat matagumpay na pagpapadala ay maaaring lumikha ng bagong lead. Dahil dito, dapat i-disable ng frontend ang button na "Ipadala" pagkatapos ng unang pag-click at hindi dapat magdulot ng anumang awtomatikong pag-uulit. Kabilang sa mga kinakailangang field na dapat punan ay ang `name`, `email`, at `message`. Ang pangalan ay dapat may haba na 2 hanggang 120 karakter, ang email address ay dapat nasa tamang format, at ang mensahe ay dapat sumunod sa mga panuntunan sa pag-validate sa server. Ang iba pang mga field ay dapat lamang ipadala kung ang mga ito ay kasama sa aktwal na schema. Ang mga hindi kilalang halaga ay hindi dapat gamitin upang kontrolin ang mga internal na katangian ng lead. Ang isang wastong form ay nagve-validate ng mga kinakailangang field sa browser, ngunit hindi lamang umaasa sa validation na ito. Ang server pa rin ang may pangunahing responsibilidad. Sa kaso ng isang error sa pag-validate, dapat markahan ng interface ang apektadong field at panatilihin ang mga input na nilalaman. Ang isang generic na mensahe ng tagumpay ay dapat lamang lumabas pagkatapos ng positibong tugon mula sa server. Ang contact form ay hindi isang ligtas na paraan para sa mga password, API key, widget token, impormasyon sa pagbabayad, o kumpletong talaan ng customer. Dapat ipahiwatig ng mga gumagamit ang layunin ng paggamit, ang produktong apektado, at isang madaling maabot na email address ng negosyo. Sa kaso ng isang isyu sa teknikal, ang pangalan ng tenant, oras, apektadong function, at mga hakbang na maaaring ulitin ay makakatulong, nang hindi nagpapadala ng hindi kinakailangang personal na impormasyon. Isang posibleng senaryo: Binibisita ng isang user ang website, pinupunan ang mga field na "Pangalan," "Email," at "Mensahe," maaaring tanggapin ang mga patakaran sa privacy ng website, at pagkatapos ay ipinapadala ang form. Ang server ay nagve-validate ng data, lumilikha ng lead, at nagbibigay ng tugon ng tagumpay. Kung ang email address ay hindi wasto o ang pangalan ay masyadong maikli, hindi gagawa ng kumpletong lead. Ang endpoint na ito ay hindi lumilikha ng tenant, nag-a-book ng package, o pinapalitan ang naka-strukturang configuration ng produkto o proseso ng konsultasyon. Upang protektahan laban sa spam at mga automated na kahilingan, dapat igalang ng client ang mga error na ibinalik ng server at hindi dapat magsimula ng mga agarang walang katapusang loop. Ang isang matagumpay na tugon ay dapat lamang i-clear ang mga field ng input kapag kinumpirma ng server ang pagtanggap. Kung walang tugon, maaaring i-save ng user ang nilalaman at ipadala muli sa ibang pagkakataon. Para sa internal na pag-uuri, ang mensahe ay dapat maglaman ng aktwal na dahilan, nang walang mga marketing na salita o mga sensitibong attachment. Ang isang malinaw na paksa at isang tumpak na paglalarawan ng problema ay makakatulong na mabawasan ang mga follow-up na tanong. Gayunpaman, ang API mismo ay hindi nagbibigay ng garantisadong prayoridad o nagpapatunay ng isang tiyak na timeframe para sa pagproseso.

{"name":"Max Mustermann","email":"max@example.com","message":"Ang iyong mensahe (minimum na 10 karakter).","consentGiven":true}

{"ok":true,"message":"Ang iyong kahilingan ay naisumite na."}