POST/api/public/contact

Ifomu lokuxhumana lomphakathi lewebhusayithi ye-Zentor. Lidala isicelo ohlelweni lwangaphakathi lwama-lead.

I-`POST /api/public/contact` icubungula ifomu lokuxhumana lomphakathi lewebhusayithi ye-Zentor futhi ilondoloze isicelo ohlelweni lwangaphakathi lwama-lead. I-endpoint ayidingi ukuqinisekisa ubuwena ku-dashboard futhi ayiyona i-idempotent. Ukuthumela ngakunye okuphumelelayo kungadala i-lead entsha. Ngakho i-frontend kufanele ivale inkinobho yokuthumela ngemva kokuchofoza kokuqala futhi ingaqalisi ukuphinda okuzenzakalelayo. Izinkambu eziyimpoqo eziqinisekisiwe yi-`name`, `email` ne-`message`. Igama kufanele libe phakathi kwezinhlamvu ezingu-2 no-120 ubude, ikheli le-imeyili kufanele libe nefomethi evumelekile, futhi umlayezo kufanele uhlangabezane nemithetho yokuqinisekisa yohlangothi lweseva. Ezinye izinkambu zingathunyelwa kuphela uma zihlinzekelwe ku-schema sangempela. Amanani angaziwa akufanele asetshenziselwe ukulawula izakhiwo zangaphakathi ze-lead. Ifomu elifanele lihlola izinkambu eziyimpoqo kakade esipheqululini, kodwa alithembeli kulokho kuhlola kuphela. Iseva ihlala iyinqumo. Uma kunephutha lokuqinisekisa, indawo kufanele iphawule inkambu ethintekayo futhi igcine okuqukethwe okufakiwe. Umlayezo wempumelelo ojwayelekile ungavela kuphela ngemva kwempendulo enhle yeseva. Ifomu lokuxhumana akusona isiteshi esiphephile samaphasiwedi, okhiye be-API, ama-widget token, idatha yokukhokha noma amarekhodi aphelele amakhasimende. Abasebenzisi kufanele banikeze isimo sokusetshenziswa, umkhiqizo othintekayo nekheli le-imeyili lebhizinisi elifinyelelekayo. Enkingeni yobuchwepheshe kusiza igama le-tenant, isikhathi, umsebenzi othintekayo nezinyathelo ezingaphindwa, ngaphandle kokudlulisa okuqukethwe komuntu siqu okungadingekile. Inqubo engokoqobo: isivakashi sigcwalisa igama, i-imeyili nomlayezo, uma kudingeka siqinisekise izaziso zokuvikelwa kwedatha zekhasi bese sithumela ifomu. Iseva iqinisekisa idatha, idale i-lead futhi ibuyise impendulo yempumelelo. Uma i-imeyili ingavumelekile noma igama lilifushane kakhulu, ayidalwa i-lead ephelele. I-endpoint ayidali i-tenant, ayibhuki iphakheji futhi ayithathi indawo yokulungiselelwa komkhiqizo okuhlelekile noma yenqubo yokwelulekwa. Ukuze kuvikelwe ku-spam nezicelo zochungechunge ezizenzakalelayo, iklayenti kufanele lihloniphe amaphutha ohlangothi lweseva futhi lingaqali izihibe ezingapheli ngokushesha. Impendulo ephumelelayo kufanele isule izinkambu zokufaka kuphela lapho iseva isiqinisekisile ukwamukela. Uma impendulo ingafiki, umsebenzisi angagcina okuqukethwe futhi akuthumele kabusha kamuva ngendlela elawulwayo. Ukuze kwabelwe ngaphakathi, umlayezo kufanele uqukathe isizathu sangempela, ngaphandle kwamagama okumaketha noma okunamathiselwe okuyimfihlo. Isihloko esicacile nencazelo enembile yenkinga kunciphisa imibuzo elandelayo. Nokho i-API ngokwayo ayiniki isiqinisekiso sokubekwa phambili futhi ayiqinisekisi isikhathi esinqunyiwe sokucubungula.

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

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