POST/api/public/consultation

Ifomu lomphakathi lesicelo sokwelulekwa lewebhusayithi ye-Zentor.

Ikhasi elithi „POST /api/public/consultation — inkomba ye-API" liphathelene nendawo yemisebenzi eshiwo ku-URL. Okuqukethwe okukhona kwengezwa ngenqubo yangempela, izimfuneko nemikhawulo eyaziwayo. Isakhi-mafomu sisekela amafomu alungiselelwa ngokukhululekile anamagama angukhiye e-trigger, izinhlobo zezinkambu nokuphawulwa kwezinkambu eziyimpoqo. Umsebenzi uhlolwe nge-E2E. Imibhalo ye-`POST /api/public/consultation` kufanele ifundwe njengencazelo yobuchwepheshe yale endpoint ethile. Okubalulekile yindlela, umzila, ukuqinisekisa ubuwena, izinkambu eziyimpoqo, amaphutha angenzeka nombuzo wokuthi ukubiza futhi kuqalisa umphumela ofanayo yini. Ngakho i-URL ekhona https://zentor-app.de/hilfe/api-referenz/formulare/forms.consultation akufanele iqukathe izitatimende zokukhangisa ezijwayelekile, kodwa kuphela izinyathelo zokuhlanganisa ezilandelekayo nezibonelo zezimpendulo ezifakazelwe. Ukuze kubizwe i-`/api/public/consultation`, isicelo sakhiwa ngokwe-registry. Imizila yomphakathi ayidingi khiye we-API wonjiniyela ojwayelekile, ngoba i-Zentor ayinikezi sistimu enjalo yokhiye. Ngakolunye uhlangothi, imizila ye-widget evikelekile isebenzisa i-embed token eboniswa kanye nokuhlolwa kwe-origin. Isimo se-HTTP nokuqukethwe kwe-JSON kufanele kuhlaziywe ndawonye; inkambu ethi `ok` iyodwa ayithathi indawo yokuphatha amaphutha. Lapho kuhlolwa i-`POST /api/public/consultation`, kufanele kusetshenziswe amanani angaziwa. Idatha yangempela yamakhasimende, ama-UUID akhiqizayo, ama-token eseshini nezitembu zesikhathi ezithile akufanele kube sezibonelweni zomphakathi. Umkhawulo owaziwayo wenkundla yonke yizicelo ezingu-2.000 phakathi kwemizuzu engu-15; umkhawulo ohlukile we-endpoint eyodwa awufakazelwe. Izingcingo ze-POST ezingeyona i-idempotent akumele ziphindwe ngokungaboni ngemva kokuphazamiseka kwenethiwekhi okungacacile. Amaphutha avamile okuhlanganisa kulo mzila avela ngenxa yemingcele eyimpoqo engekho, izinhlobo zedatha ezingalungile, amakhodi asebenza kanye aphelelwe yisikhathi, ama-origin angavunyelwe noma irekhodi elingekho kusengaphambili. Uhlelo kufanele luphathe lezi zimo ngokwehlukana futhi lurekhode umlayezo wephutha obuyiswe yi-endpoint, ngaphandle kokubhala okuqukethwe okuyimfihlo. Isicelo esiphumelelayo siqinisekisa kuphela lesi sinyathelo sokucubungula, hhayi ngokuzenzakalelayo impumelelo elandelayo ye-imeyili, yenkokhelo noma ye-SSO. Lokhu kubaluleke ngqo ku-„POST /api/public/consultation". Ukuhlolwa kobuchwepheshe kwaleli khasi kufanele kusekelwe ngokubophezelayo ku-registry ethi `app/frontend/src/content/api-reference/` nemizila ye-backend ehambisanayo. Amanothi okuhlola bukhoma angasho kuphela lokho okuhloliwe ngempela. Ukuhlola okungemuhle noma ukuqhathanisa kwekhodi akusibo ubufakazi obuphelele bempumelelo. Ngakho ku-POST /api/public/consultation — inkomba ye-API kufanele kuhlukaniswe ngokucacile phakathi kwesakhiwo esibhaliwe, ukuhlola okuzenzakalelayo nokuziphatha bukhoma okubonwe ngokuqinisekile.

{"name":"Max Mustermann","email":"max@example.com","company":"Musterfirma","message":"Indaba","consentGiven":true}

{"ok":true,"message":"Isicelo sakho sokweluleka sithunyelwe. Sizoxhumana nawe maduze."}