POST/api/public/contact

Принимает запрос из контактной формы на сайте Zentor App и передаёт его команде Zentor.

Обязательные поля: `name` (2–120 символов), `email` (действительный email-адрес), `message` (10–3000 символов) и `consentGiven`, которое должно быть установлено в `true`. Опционально можно отправить `company`, `phone` и `topic`. При успехе сервер отвечает `{"ok":true}` и сообщением подтверждения. Если обязательное поле отсутствует, недействительно или отсутствует согласие, эндпоинт отвечает кодом 400 `VALIDATION_ERROR`; поле `details` перечисляет отдельные ошибки, чтобы вы могли отметить соответствующие поля ввода. Каждая успешная отправка создаёт новый запрос. Поэтому блокируйте кнопку отправки до получения ответа и не повторяйте вызов автоматически. Не более 10 запросов за 15 минут на IP-адрес. Дополнительно действуют правила доступа Zentor (правила по IP, странам и доменам email); отклонённые вызовы получают код 403.

Обзор

Вызов: POST /api/public/contact. Этот эндпоинт относится к группе «Публичные формы» API Zentor App. Он общедоступен и не требует аутентификации. Вызов не идемпотентен: каждый успешный вызов заново запускает действие. Обязательные параметры: name (тело), email (тело), message (тело), consentGiven (тело). Необязательные параметры: company (тело), phone (тело), topic (тело). Задокументированные случаи ошибок: 400 VALIDATION_ERROR. Пример ответа ниже показывает структуру успешного ответа в формате JSON.

Аутентификация и защита

Аутентификация не требуется

Идемпотентный: Нет

Параметры

name(body, string, обязательно)— Имя, 2–120 символов
email(body, string, обязательно)— Действительный email-адрес
message(body, string, обязательно)— Сообщение, 10–3000 символов
company(body, string)— Компания (опционально)
phone(body, string)— Номер телефона (опционально)
topic(body, string)— Тема запроса (опционально)
consentGiven(body, boolean, обязательно)— Согласие на обработку данных, должно быть `true`

Пример запроса

{"name":"Max Mustermann","email":"max@example.com","message":"Ваше сообщение (не менее 10 символов).","consentGiven":true}

Пример ответа

{"ok":true,"message":"Ваш запрос отправлен."}

Коды ошибок

400 VALIDATION_ERROR — Обязательное поле отсутствует или недействительно, либо отсутствует согласие на обработку данных. `details` содержит отдельные сообщения об ошибках.

Проверенное поведение

Полные данные возвращают 200; отсутствующие обязательные поля или отсутствующее согласие возвращают 400 `VALIDATION_ERROR`.

Публичные формы

POST /api/public/consultationПринимает запрос на консультацию из формы на сайте Zentor App.POST /api/public/access-requestОтправляет заявку на доступ к пакету (Starter, «Индивидуальный» или 14-дневная демоверсия). Требуется предварительно подтверждённый email.POST /api/public/access-request/email/start-verificationОтправляет шестизначный код подтверждения, действительный 10 минут, на указанный email — первый шаг заявки на доступ.POST /api/public/access-request/email/verifyПроверяет код, доставленный по email, и выдаёт токен подтверждения для последующей заявки на доступ.GET /api/public/access-request/payment-statusУказывает, какие способы оплаты (PayPal, Stripe) сейчас доступны для заявки на доступ.GET /api/public/access-request/paypal/configВозвращает публичную конфигурацию PayPal (активен, режим, валюта) для шага оплаты.POST /api/public/access-request/paypal/create-orderСоздаёт заказ PayPal для выбранного пакета.POST /api/public/access-request/paypal/capture-orderЗавершает (captures) ранее созданный заказ, подтверждённый покупателем в PayPal-checkout. Сумму устанавливает исключительно сервер.POST /api/public/access-request/stripe/create-checkoutСоздаёт сессию Stripe-checkout для выбранного пакета.POST /api/public/activate-accountАктивирует новоcозданную учётную запись пользователя и устанавливает первый пароль — запускается по ссылке в приглашающем письме.

Связанные статьи

← Публичные формы