POST/api/public/consultation

A Zentor weboldal nyilvános tanácsadási kéreleműrlapja.

A „POST /api/public/consultation — API-Referencia“ oldal a URL-ben jelölt funkcióterületet tárgyalja. A meglévő tartalmat kiegészítjük a tényleges végrehajtási folyamattal, az előfeltételekkel és a ismert korlátokkal. A űrlap-építő készlet szabadon konfigurálható űrlapokat támogatott trigger kulcsszavakkal, mezőtípusokkal és kötelező mező jelöléssel. A funkció E2E-tesztelt. A `POST /api/public/consultation` dokumentációját ennek a konkrét végpontnak a műszaki leírásaként kell értelmezni. Döntő fontosságú a módszer, az elérési út, a hitelesítés, a kötelező mezők, a lehetséges hibák és az a kérdés, hogy egy újrahívás ugyanazt a hatást váltja-e ki. A jelenlegi URL https://zentor-app.de/hilfe/api-referenz/formulare/forms.consultation ezért nem tartalmazhat általános reklámállításokat, csakis azonnal végrehajtható integrációs lépéseket és igazolt válasz példákat. A `/api/public/consultation` hívásához a kérést a Regiszter szerint kell felépíteni. A nyilvános útvonalakhoz nem szükséges általános fejlesztői API-kulcs, mivel a Zentor nem kínál ilyen kulcsrendszert. A védett widget útvonalak ezzel szemben az egyszer megjelenített Embed-Token-t és egy Origin-ellenőrzést használnak. Az HTTP státuszkódot és a JSON tartalmat együttesen kell kiértékelni; egy `ok` mező önmagában nem helyettesíti a hibakezelést. A `POST /api/public/consultation` tesztelésénél anonimizált értékeket kell használni. Valós ügyféladatok, éles UUID-k, munkamenet-tokenek és konkrét időbélyegek nem tartoznak a nyilvános példák közé. Az ismert platform-szintű korlát 2.000 kérés 15 percen belül; eltérő egyedi limit nem igazolt. Nem idempotens POST hívásokat nem szabad vakon ismételni hálózati megszakadás esetén. Ennek az útvonalnak a tipikus integrációs hibái a hiányzó kötelező paraméterek, a helytelen adattípusok, a lejárt egyszeri kódok, a nem engedélyezett Origin-ek vagy az előre nem létező adatbejegyzések miatt merülnek fel. Az alkalmazásnak ezeket az eseteket külön kell kezelnie, és naplóznia kell a végpont által visszaadott hibaüzenetet, titkos tartalmak rögzítése nélkül. Egy sikeres kérés csak ezt a feldolgozási lépést igazolja, nem feltétlenül egy azonnali e-mail-, fizetési vagy SSO-sikert. Ez közvetlenül releváns a „POST /api/public/consultation” esetében. Ennek az oldalnak a műszaki ellenőrzése kötelezően a `app/frontend/src/content/api-reference/` alatti Regiszterre és a hozzá tartozó backend útvonalakra támaszkodjon. A élő teszt megjegyzések csak azt állíthatják, amit ténylegesen ellenőriztek. Egy negatív teszt vagy egy kód-analógia nem teljes sikerkövetelmény. A POST /api/public/consultation — API-Referencia esetében ezért egyértelműen meg kell különböztetni a dokumentált struktúrát, az automatizált tesztet és a biztonságosan megfigyelt élő viselkedést.

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

{"ok":true,"message":"A tanácsadási kérését elküldtük. Hamarosan felvesszük Önnel a kapcsolatot."}