POST/api/public/contact
Ifom yoqhagamshelwano yoluntu yewebhusayithi ye-Zentor. Yenza isicelo kwinkqubo yangaphakathi yee-lead.
`POST /api/public/contact` iqhuba ifom yoqhagamshelwano yoluntu yewebhusayithi ye-Zentor kwaye igcine isicelo kwinkqubo yangaphakathi yee-lead. Le ndawo yokuphela ayifuni kuqinisekiswa kwe-dashboard kwaye ayiyiyo idempotent. Ukuthunyelwa ngempumelelo ngakunye kunokwenza i-lead entsha. Ngoko ke i-frontend kufuneka ivale iqhosha lokuthumela emva kokucofa kokuqala kwaye ingaqalisi ukuphinda okuzenzekelayo. Iintsimi ezinyanzelekileyo eziqinisekisiweyo zezi `name`, `email` kunye ne-`message`. Igama kufuneka libe phakathi kwabalinganiswa aba-2 ukuya kwali-120 ubude, idilesi ye-imeyile kufuneka ibe nefomathi esebenzayo, kwaye umyalezo kufuneka uzalisekise imithetho yokuqinisekisa yeseva. Ezinye iintsimi zinokuthunyelwa kuphela ukuba zichazwe kwi-schema yokwenyani. Amaxabiso angaziwayo akufuneki asetyenziselwe ukulawula iimpawu zangaphakathi ze-lead. Ifom echanekileyo ihlola iintsimi ezinyanzelekileyo sele kwibhrawuza, kodwa ayixhomekeki kuphela kolu hlolo. Iseva ihlala iyeyona igqibayo. Xa kukho impazamo yokuqinisekisa, ujongano kufuneka luphawule intsimi echaphazelekayo kwaye lugcine umxholo ofakiweyo. Umyalezo wempumelelo jikelele unokuvela kuphela emva kwempendulo elungileyo yeseva. Ifom yoqhagamshelwano ayisilojelo likhuselekileyo leephasiwedi, izitshixo ze-API, ii-token ze-widget, idatha yokuhlawula okanye iirekhodi ezipheleleyo zabathengi. Abasebenzisi kufuneka banike imeko yokusetyenziswa, imveliso echaphazelekayo nedilesi ye-imeyile yeshishini efikelelekayo. Kwingxaki yobuchwepheshe, igama le-tenant, ixesha, umsebenzi ochaphazelekayo namanyathelo anokuphindwa ayanceda, ngaphandle kokudlulisela umxholo wobuqu ongeyomfuneko. Inkqubo yokwenyani: undwendwe lugcwalisa igama, i-imeyile nomyalezo, luqinisekise izaziso zokhuseleko lwedatha zephepha xa kufuneka kwaye luthumele ifom. Iseva iqinisekisa idatha, yenze i-lead kwaye inike impendulo yempumelelo. Xa i-imeyile ingasebenzi okanye igama lifutshane kakhulu, akwenziwa i-lead epheleleyo. Le ndawo yokuphela ayenzi tenant, ayibhukishi pakethi kwaye ayithathi ndawo yoqwalaselo lwemveliso olucwangcisiweyo okanye inkqubo yengcebiso. Ukuze kukhuselwe kwi-spam nakwizicelo ezizenzekelayo ezilandelelanayo, umthengi-software kufuneka ahloniphe iimpazamo zeseva kwaye angaqalisi iilophu ezingapheliyo kwangoko. Impendulo ephumeleleyo kufuneka icime iintsimi zokufaka kuphela xa iseva iqinisekisile ukwamkelwa. Ukuba impendulo ayifiki, umsebenzisi unokugcina umxholo aze awuthumele kwakhona kamva ngendlela elawulwayo. Ukuze kwabelwe ngaphakathi, umyalezo kufuneka uqulathe isizathu sokwenyani, ngaphandle kwamabinzana entengiso okanye izincamathiselo eziyimfihlo. Isihloko esicacileyo nenkcazo echanekileyo yengxaki inciphisa imibuzo elandelayo. Nangona kunjalo, i-API ngokwayo ayiniki kubaluleka okuqinisekisiweyo kwaye ayiqinisekisi xesha limiselweyo lokuqhuba.
Ukuqinisekiswa nokhuseleko
Akukho kuqinisekiswa kufunekayo
Idempotent: Hayi
Iiparamitha
name(body, string, kuyafuneka)— Iimpawu ezingama-2–120email(body, string, kuyafuneka)— Idilesi ye-imeyile esebenzayomessage(body, string, kuyafuneka)— Iimpawu ezili-10–3000company(body, string)phone(body, string)topic(body, string)consentGiven(body, boolean, kuyafuneka)— Kufuneka ibe yi-true (imvume yokhuseleko lwedatha)Umzekelo we-request
{"name":"Max Mustermann","email":"max@example.com","message":"Umyalezo wakho (ubuncinci abalinganiswa abali-10).","consentGiven":true}Umzekelo we-response
{"ok":true,"message":"Isicelo sakho sithunyelwe."}Iikhowudi zeempazamo
400 VALIDATION_ERROR — Intsimi enyanzelekileyo ayikho/ayisebenzi, okanye imvume yokhuseleko lwedatha ayikho (uluhlu lweenkcukacha olunemiyalezo yempazamo nganye).Ubungqina bovavanyo oluphilayo
Impumelelo (200) kunye nemeko engaphumelelanga (400, iindawo ezingekho kubandakanywa nemvume engekhoyo) ziqinisekisiwe ngqo.