POST/api/public/contact

Ifomu yokuxhumana yomphakathi yewebhusayithi yeZentor. Yenza isicelo kuhlelo lwangaphakathi lwama-lead.

I-`POST /api/public/contact` isebenza ifomu yokuxhumana yomphakathi yewebhusayithi yeZentor njalo igcina isicelo kuhlelo lwangaphakathi lwama-lead. I-endpoint kayidingi ukuqinisekiswa kwe-Dashboard njalo kayisiyo idempotent. Ukuthumela ngakunye okuphumeleleyo kungenza i-lead entsha. Ngakho i-frontend kumele ivale inkinobho yokuthumela ngemva kokucindezela kokuqala njalo ingaqalisi ukuphinda okuzenzakalelayo. Izigaba ezifunekayo eziqinisekisiweyo yi-`name`, i-`email` le-`message`. Ibizo kumele libe lobude obuphakathi kwezimpawu ezingu-2 lezingu-120, ikheli le-imeyili kumele libe lefomethi elungileyo, njalo umlayezo kumele uhambelane lemithetho yokuqinisekisa yeseva. Ezinye izigaba zingathunyelwa kuphela nxa zihlelwe ku-schema yeqiniso. Amanani angaziwayo akumelanga asetshenziselwe ukulawula izimpawu zangaphakathi ze-lead. Ifomu elungileyo ihlola izigaba ezifunekayo kusesebhrawuzeni, kodwa kayithembeli kuphela kulokhu kuhlola. Iseva yiyo ehlala iqakathekile. Nxa kulephutha lokuqinisekisa, isikhangiso kumele siphawule isigaba esithintekayo njalo sigcine okufakiweyo. Umlayezo wempumelelo ojwayelekileyo ungavela kuphela ngemva kwempendulo enhle yeseva. Ifomu yokuxhumana kayisiso isiteshi esivikelekileyo samaphasiwedi, ama-API key, ama-token e-widget, idatha yokubhadala kumbe amarekhodi apheleleyo amakhasimende. Abasebenzisi kumele banike isimo sokusetshenziswa, umkhiqizo othintekayo lekheli le-imeyili lebhizinisi elifinyelelekayo. Nxa kulenkinga yobuchwepheshe, kuyasiza ibizo lomqashi, isikhathi, umsebenzi othintekayo lezinyathelo ezingaphindwa, ngaphandle kokuthumela okuqukethwe komuntu okungadingekiyo. Inqubo eqotho: Umvakatshi ugcwalisa ibizo, i-imeyili lomlayezo, nxa kufanele avume izaziso zokuvikelwa kwedatha zekhasi, bese ethumela ifomu. Iseva iqinisekisa idatha, yenza i-lead njalo ilethe impendulo yempumelelo. Nxa i-imeyili ingalunganga kumbe ibizo lifitshane kakhulu, kakwenziwa i-lead epheleleyo. I-endpoint kayenzi umqashi, kayibhukhi iphakheji njalo kayithathi indawo yokuhlelwa komkhiqizo okuhlelekileyo kumbe inqubo yokweluleka. Ukuze kuvikelwe ku-spam lezicelo ezinengi ezizenzakalelayo, i-client kumele ihloniphe amaphutha eseva njalo ingaqali amaluphu angapheliyo masinyane. Impendulo ephumeleleyo kumele isule izigaba zokufaka kuphela ngemva kokuthi iseva iqinisekise ukwamukela. Nxa impendulo ingafiki, umsebenzisi angagcina okuqukethwe athumele kutsha ngokulawulwa ngemva kwesikhathi. Ukuze kuhlelwe ngaphakathi, umlayezo kumele uqukathe isizatho seqiniso, ngaphandle kwamazwi okukhangisa kumbe okunamathiselweyo okuyimfihlo. Isihloko esicacileyo lencazelo eqondileyo yenkinga kunciphisa imibuzo yokubuyela. Kodwa i-API ngokwayo kayiniki ukuqakatheka okuqinisekisiweyo njalo kayiqinisekisi isikhathi esimisiweyo sokusebenza.

{"name":"Max Mustermann","email":"max@example.com","message":"Umlayezo wakho (okungenani izimpawu ezingu-10).","consentGiven":true}

{"ok":true,"message":"Isicelo sakho sithunyelwe."}