POST/api/public/consultation

Fomu ya umma ya ombi la ushauri kwenye tovuti ya Zentor.

Ukurasa „POST /api/public/consultation — Marejeleo ya API“ unashughulikia eneo la utendaji lililotajwa katika URL. Maudhui yaliyopo yanaongezewa mtiririko halisi, masharti ya awali na mipaka inayojulikana. Kijenzi cha fomu kinasaidia fomu zinazosanidiwa kwa uhuru zenye maneno muhimu ya kichochezi, aina za sehemu na alama ya sehemu za lazima. Kipengele hiki kimejaribiwa E2E. Nyaraka za `POST /api/public/consultation` lazima zisomwe kama maelezo ya kiufundi ya endpoint hii mahususi. Mambo muhimu ni method, path, uthibitishaji, sehemu za lazima, hitilafu zinazowezekana na swali la iwapo kuita tena kunaleta athari ileile. Kwa hivyo URL hii https://zentor-app.de/hilfe/api-referenz/formulare/forms.consultation haipaswi kuwa na madai ya jumla ya kimatangazo, bali hatua za muunganisho zinazoweza kufuatiliwa na mifano ya majibu iliyothibitishwa pekee. Kwa kuita `/api/public/consultation`, ombi hujengwa kulingana na Registry. Njia za umma hazihitaji ufunguo wa jumla wa API wa wasanidi, kwa sababu Zentor haitoi mfumo kama huo wa funguo. Kinyume chake, njia za widget zilizolindwa hutumia embed token inayoonyeshwa mara moja pamoja na ukaguzi wa origin. Hali ya HTTP na maudhui ya JSON lazima vitathminiwe pamoja; sehemu ya `ok` peke yake haichukui nafasi ya kushughulikia hitilafu. Wakati wa kujaribu `POST /api/public/consultation`, thamani zisizotambulisha watu zinapaswa kutumika. Data halisi ya wateja, UUID za mfumo wa uzalishaji, tokeni za vipindi na mihuri halisi ya muda haziruhusiwi katika mifano ya umma. Kikomo kinachojulikana cha jukwaa zima ni maombi 2.000 ndani ya dakika 15; kikomo tofauti mahususi hakijathibitishwa. Maombi ya POST yasiyo idempotent hayapaswi kurudiwa bila kufikiri baada ya kukatika kwa mtandao kusikoeleweka. Hitilafu za kawaida za muunganisho kwa njia hii husababishwa na vigezo vya lazima vinavyokosekana, aina zisizo sahihi za data, misimbo ya matumizi moja iliyokwisha muda, origins zisizoruhusiwa au rekodi ya data ambayo haikuwepo awali. Programu inapaswa kushughulikia hali hizo kando na kurekodi ujumbe wa hitilafu unaorudishwa na endpoint bila kuandika maudhui ya siri. Ombi lililofanikiwa linathibitisha hatua hii ya uchakataji pekee, si moja kwa moja kufanikiwa kwa barua pepe, malipo au SSO kunakofuata baadaye. Hili linahusika moja kwa moja kwa „POST /api/public/consultation“. Ukaguzi wa kiufundi wa ukurasa huu lazima utegemee Registry iliyo chini ya `app/frontend/src/content/api-reference/` na njia za backend zinazohusiana. Maelezo ya majaribio ya moja kwa moja yanaweza kudai tu kile kilichokaguliwa kweli. Jaribio hasi au mfanano wa msimbo si uthibitisho kamili wa mafanikio. Kwa hivyo kwa POST /api/public/consultation — Marejeleo ya API lazima kutofautishwe waziwazi kati ya muundo ulioandikwa, jaribio la kiotomatiki na tabia ya moja kwa moja iliyoshuhudiwa kwa uhakika.

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

{"ok":true,"message":"Ihre Beratungsanfrage wurde übermittelt. Wir melden uns in Kürze bei Ihnen."}