POST/api/public/consultation

Публічна форма запиту на консультації сайту Zentor.

Сторінка «POST /api/public/consultation — довідник API» описує функціональну область, зазначену в URL. Наявний вміст доповнюється фактичним перебігом, передумовами та відомими обмеженнями. Конструктор форм підтримує вільно налаштовувані форми з ключовими словами-тригерами, типами полів та позначенням обов'язкових полів. Функція протестована наскрізно (E2E). Документацію щодо `POST /api/public/consultation` слід читати як технічний опис цього конкретного ендпоінта. Вирішальними є метод, шлях, автентифікація, обов'язкові поля, можливі помилки та питання, чи повторний виклик спричиняє той самий ефект. Тому наведена URL https://zentor-app.de/hilfe/api-referenz/formulare/forms.consultation не повинна містити загальних рекламних тверджень, а лише простежувані кроки інтеграції та підтверджені приклади відповідей. Для виклику `/api/public/consultation` запит формується відповідно до реєстру. Публічні маршрути не потребують загального API-ключа розробника, оскільки Zentor не пропонує такої системи ключів. Захищені маршрути віджета натомість використовують токен вбудовування, що показується один раз, та перевірку Origin. HTTP-статус і вміст JSON необхідно оцінювати разом; поле `ok` саме по собі не замінює обробку помилок. Під час тестування `POST /api/public/consultation` слід використовувати анонімізовані значення. Реальні дані клієнтів, продуктивні UUID, токени сесій та конкретні часові мітки не належать до публічних прикладів. Відоме загальноплатформне обмеження становить 2.000 запитів протягом 15 хвилин; окремий індивідуальний ліміт не підтверджений. Неідемпотентні POST-виклики не слід сліпо повторювати після нез'ясованого обриву мережі. Типові помилки інтеграції для цього маршруту виникають через відсутні обов'язкові параметри, неправильні типи даних, прострочені одноразові коди, недозволені Origin або запис, якого не було створено заздалегідь. Застосунок має обробляти такі випадки окремо та протоколювати повідомлення про помилку, яке повертає ендпоінт, не записуючи секретного вмісту. Успішний запит підтверджує лише цей крок обробки, а не автоматично успіх подальшого процесу електронної пошти, платежу чи SSO. Для «POST /api/public/consultation» це безпосередньо актуально. Технічна перевірка цієї сторінки має обов'язково спиратися на реєстр у `app/frontend/src/content/api-reference/` та відповідні маршрути бекенду. Примітки щодо live-тестів можуть стверджувати лише те, що було фактично перевірено. Негативний тест або аналогія з кодом не є повним доказом успіху. Тому для POST /api/public/consultation — довідник API необхідно чітко розрізняти задокументовану структуру, автоматизований тест і достовірно спостережувану поведінку наживо.

{"name":"Max Mustermann","email":"max@example.com","company":"Musterfirma","message":"Питання","consentGiven":true}

{"ok":true,"message":"Ваш запит на консультацію надіслано. Ми зв'яжемося з вами найближчим часом."}