POST/api/public/consultation

Ifomu yomphakathi yesicelo sokweluleka yewebhusayithi yeZentor.

Ikhasi elithi „POST /api/public/consultation — Ireferensi ye-API“ liphatha isigaba somsebenzi esibizwe ku-URL. Okuqukethweyo okukhona kwengezelelwa ngenqubo yeqiniso, izidingo kanye lemikhawulo eyaziwayo. Umakhi wamafomu usekela amafomu ahlelwa ngokukhululekileyo alamagama angundoqo e-trigger, inhlobo zezinkundla lokuphawulwa kwezinkundla eziyisibopho. Umsebenzi uhloliwe nge-E2E. Incwadi echaza i-`POST /api/public/consultation` kumele ifundwe njengencazelo yobuchwepheshe yale endpoint eqondileyo. Okuqakathekileyo yindlela (method), indlela ye-path, ukuqinisekisa ubuwena, izinkundla eziyisibopho, amaphutha angenzakala kanye lombuzo wokuthi ukubiza futhi kuletha umphumela ofananayo yini. Ngakho i-URL ekhona https://zentor-app.de/hilfe/api-referenz/formulare/forms.consultation kayimelanga ibe lezitatimende zokukhangisa ezijwayelekileyo, kodwa izinyathelo zokuhlanganisa ezilandelekayo kuphela lezibonelo zezimpendulo ezifakazelweyo. Ekubizeni i-`/api/public/consultation`, isicelo sakhiwa ngokuvumelana le-Registry. Imizila yomphakathi kayidingi isikhiye se-API sabathuthukisi esijwayelekileyo, ngoba uZentor kanikezi uhlelo olunjalo lwezikhiye. Imizila ye-widget evikelweyo yona isebenzisa i-Embed-Token eboniswa kanye kuphela lokuhlolwa kwe-Origin. Isimo se-HTTP lokuqukethwe kwe-JSON kumele kuhlolwe ndawonye; inkundla ye-`ok` yodwa kayithathi indawo yokuphatha amaphutha. Ekuhloleni i-`POST /api/public/consultation` kumele kusetshenziswe amanani angaziwayo (anonymised). Idatha yeqiniso yamakhasimende, ama-UUID okukhiqiza, ama-token ezikhathi zokungena lezitembu zesikhathi eziqondileyo kakumelanga kube sezibonelweni zomphakathi. Umkhawulo owaziwayo we-platform yonke yizicelo ezingu-2.000 phakathi kwemizuzu engu-15; umkhawulo othile ohlukileyo kawufakazelwanga. Izibizo ze-POST ezingasi-idempotent kazimelanga ziphindwe ngobuphofu ngemva kokuqamuka kwenethiwekhi okungacacanga. Amaphutha okuhlanganisa avamileyo kulo mzila avela ngenxa yamapharamitha ayisibopho angekho, inhlobo zedatha ezingalunganga, amakhodi okusetshenziswa kanye aphelelwe yisikhathi, ama-Origin angavunyelwanga kumbe irekhodi ledatha elingakhonanga ngaphambili. Uhlelo kumele luphathe izimo ezinjalo ngokwehlukeneyo njalo lubhale kulogi umlayezo wephutha obuyiswe yi-endpoint, ngaphandle kokubhala okuqukethweyo okuyimfihlo. Isicelo esiphumeleleyo siqinisekisa kuphela lesi sinyathelo sokusetshenzwa, hatshi ngokuzenzakalela impumelelo elandelayo ye-imeyili, yokubhadala kumbe ye-SSO. Lokhu kuqakathekile ngqo ku-„POST /api/public/consultation“. Ukuhlolwa kobuchwepheshe kwaleli khasi kumele kusekelwe ngokubophayo ku-Registry engaphansi kwe-`app/frontend/src/content/api-reference/` lemizileni ye-backend ehambelana layo. Amanothi okuhlola okuphilayo angaveza kuphela lokho okuhlolwe ngempela. Ukuhlola okuphikisayo (negative test) kumbe ukufanisa lekhodi kakusibo ubufakazi obupheleleyo bempumelelo. Ngakho ku-POST /api/public/consultation — Ireferensi ye-API kumele kwehlukaniswe ngokucacileyo phakathi kwesakhiwo esibhaliweyo, ukuhlola okuzenzakalelayo kanye lokuziphatha okuphilayo okubonwe ngokuqinisekileyo.

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

{"ok":true,"message":"Isicelo sakho sokululekwa sithunyelwe. Sizaxhumana lawe masinyane."}