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 не предоставляет такой системы ключей. Защищенные маршруты виджетов, напротив, используют отображаемый один раз embed-токен и проверку Origin. HTTP-статус и содержимое JSON должны оцениваться совместно; одно поле `ok` не заменяет обработку ошибок. При тестировании `POST /api/public/consultation` следует использовать анонимизированные значения. Реальные данные клиентов, производственные UUID, токены сессии и конкретные временные метки не должны попадать в публичные примеры. Известное общее ограничение платформы составляет 2.000 запросов в течение 15 минут; отдельное ограничение не подтверждено. Неидемпотентные POST-вызовы после неясного сбоя сети не следует повторять слепо. Типичные ошибки интеграции для этого маршрута возникают из-за отсутствия обязательных параметров, неверных типов данных, истекших одноразовых кодов, недопустимых Origins или отсутствия записи заранее. Приложение должно обрабатывать такие случаи отдельно и регистрировать сообщение об ошибке, возвращаемое эндпоинтом, не записывая при этом конфиденциальные данные. Успешный запрос подтверждает только этот шаг обработки, а не автоматически успех последующей отправки email, платежа или SSO. Это непосредственно актуально для «POST /api/public/consultation». Техническая проверка этой страницы должна строго опираться на реестр в `app/frontend/src/content/api-reference/` и соответствующие маршруты бэкенда. Упоминания тестов в режиме реального времени могут утверждать только то, что было фактически проверено. Отрицательный тест или аналогия кода не являются полным доказательством успеха. Поэтому для POST /api/public/consultation — API-ссылки четко следует различать документированную структуру, автоматизированный тест и надежно наблюдаемое поведение в реальном времени.

{"name":"Max Mustermann","email":"max@example.com","company":"Musterfirma","message":"Обращение","consentGiven":true}

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