POST/api/public/consultation

Verejný formulár na dopyt na konzultáciu na webe Zentor.

Stránka „POST /api/public/consultation — referencia API“ sa venuje funkčnej oblasti označenej v URL. Existujúci obsah sa dopĺňa o skutočný priebeh, predpoklady a známe obmedzenia. Nástroj na tvorbu formulárov podporuje voľne konfigurovateľné formuláre s kľúčovými slovami spúšťačov, typmi polí a označením povinných polí. Funkcia je otestovaná E2E. Dokumentáciu k `POST /api/public/consultation` treba záväzne čítať ako technický popis tohto konkrétneho koncového bodu. Rozhodujúce sú metóda, cesta, autentifikácia, povinné polia, možné chyby a otázka, či opakované volanie vyvolá rovnaký účinok. Táto URL https://zentor-app.de/hilfe/api-referenz/formulare/forms.consultation preto nesmie obsahovať všeobecné reklamné tvrdenia, ale iba zrozumiteľné integračné kroky a doložené príklady odpovedí. Pri volaní `/api/public/consultation` sa požiadavka zostavuje podľa registra (Registry). Verejné cesty nepotrebujú všeobecný API kľúč pre vývojárov, pretože Zentor takýto systém kľúčov neponúka. Chránené cesty widgetu naopak používajú jednorazovo zobrazený embed token a kontrolu pôvodu (Origin). Stav HTTP a obsah JSON sa musia vyhodnocovať spoločne; samotné pole `ok` nenahrádza ošetrenie chýb. Pri testovaní `POST /api/public/consultation` treba používať anonymizované hodnoty. Skutočné údaje zákazníkov, produktívne UUID, tokeny relácií a konkrétne časové pečiatky nepatria do verejných príkladov. Známy limit pre celú platformu je 2.000 požiadaviek v priebehu 15 minút; odlišný samostatný limit nie je doložený. Neidempotentné volania POST sa po nejasnom prerušení siete nesmú naslepo opakovať. Typické integračné chyby pri tejto ceste vznikajú v dôsledku chýbajúcich povinných parametrov, nesprávnych dátových typov, vypršaných jednorazových kódov, nepovolených pôvodov (origins) alebo vopred neexistujúceho záznamu. Aplikácia by mala takéto prípady ošetrovať oddelene a chybové hlásenie vrátené koncovým bodom zaprotokolovať bez zaznamenávania tajných údajov. Úspešná požiadavka potvrdzuje iba tento krok spracovania, nie automaticky následný úspech e-mailu, platby alebo SSO. Pre „POST /api/public/consultation“ je to priamo relevantné. Technická kontrola tejto stránky sa musí záväzne opierať o register v `app/frontend/src/content/api-reference/` a príslušné backendové cesty. Poznámky k živým testom smú tvrdiť iba to, čo bolo skutočne overené. Negatívny test ani analógia v kóde nie sú úplným dôkazom úspechu. Pri stránke POST /api/public/consultation — referencia API preto treba jasne rozlišovať medzi zdokumentovanou štruktúrou, automatizovaným testom a spoľahlivo pozorovaným správaním v živej prevádzke.

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

{"ok":true,"message":"Vaša požiadavka na konzultáciu bola odoslaná. Čoskoro sa vám ozveme."}