POST/api/public/consultation

Veřejný formulář žádosti o poradenství webových stránek Zentor.

Stránka „POST /api/public/consultation — API-Referenz" se zabývá funkční oblastí označenou v URL. Stávající obsah je doplněn o skutečný průběh, předpoklady a známé limity. Stavebnice formulářů podporuje volně konfigurovatelné formuláře s klíčovými slovy spouštěčů, typy polí a označením povinných polí. Funkce je testována E2E. Dokumentaci k `POST /api/public/consultation` je třeba číst jako technický popis tohoto konkrétního endpointu. Rozhodující jsou metoda, cesta, autentizace, povinná pole, možné chyby a otázka, zda opětovné volání vyvolá stejný efekt. Předmětná URL https://zentor-app.de/hilfe/api-referenz/formulare/forms.consultation proto nesmí obsahovat obecná reklamní tvrzení, ale pouze okamžitě proveditelné integrační kroky a doložené příklady odpovědí. Pro volání `/api/public/consultation` je požadavek sestaven podle registru. Veřejné trasy nevyžadují obecný vývojářský API klíč, protože Zentor žádný takový systém klíčů nenabízí. Chráněné trasy widgetů naopak používají jednorázově zobrazený embed token a kontrolu původu (origin). Stav HTTP a obsah JSON je třeba vyhodnocovat společně; samotné pole `ok` nenahrazuje zpracování chyb. Při testování `POST /api/public/consultation` je třeba použít anonymizované hodnoty. Skutečná zákaznická data, produkční UUID, session tokeny a konkrétní časová razítka nepatří do veřejných příkladů. Známý celoplatformní limit je 2.000 požadavků během 15 minut; odlišný individuální limit není doložen. Neidempotentní POST volání nesmí být po nejasném přerušení sítě slepě opakována. Typické integrační chyby pro tuto trasu vznikají kvůli chybějícím povinným parametrům, nesprávným datovým typům, prošlým jednorázovým kódům, nepovoleným origins nebo záznamu, který neexistuje předem. Aplikace by měla takové případy zpracovávat odděleně a zaznamenávat chybovou hlášku vrácenou endpointem, aniž by zapisovala tajný obsah. Úspěšný request potvrzuje pouze tento krok zpracování, nikoli automaticky úspěch následného e-mailu, platby nebo SSO. To je bezprostředně relevantní pro „POST /api/public/consultation“. Technická kontrola této stránky se má závazně opírat o registr v `app/frontend/src/content/api-reference/` a související backendové trasy. Poznámky o živém testu smí tvrdit pouze to, co bylo skutečně otestováno. Negativní test nebo analogie kódu není úplným důkazem úspěchu. Pro POST /api/public/consultation — API referenci je proto třeba jasně rozlišovat mezi dokumentovanou strukturou, automatizovaným testem a spolehlivě pozorovaným živým chováním.

{"name":"Jan Novák","email":"max@example.com","company":"Vzorová firma","message":"záležitost","consentGiven":true}

{"ok":true,"message":"Vaše žádost o konzultaci byla odeslána. Brzy se vám ozveme."}