POST/api/public/access-request

Отправляет заявку на доступ к пакету (Starter, «Индивидуальный» или 14-дневная демоверсия). Требуется предварительно подтверждённый email.

Сначала подтвердите email через `POST /api/public/access-request/email/start-verification` и `POST /api/public/access-request/email/verify`. Затем отправьте `name`, тот же `email`, пакет `package` (`starter`, `individual` или `demo_access`) и полученный `verification_token`. Опционально можно указать `company`, `phone`, `companyWebsite`, `paymentMethod` (`paypal`, `kreditkarte`, `rechnung`, `stripe_card` или `stripe_sepa`), `wish` (`trial`, `subscription` или `offer`; для демо-доступа всегда `trial`) и `message`. Без действительного подтверждения сервер отвечает кодом 400 `EMAIL_NOT_VERIFIED`. Отсутствующие обязательные поля или недействительные значения пакета, способа оплаты или пожелания приводят к коду 400 `VALIDATION_ERROR`. Каждая успешная заявка создаётся заново и обрабатывается Zentor; поэтому не повторяйте вызов автоматически. Не более 10 запросов за 15 минут на IP-адрес. Дополнительно действуют правила доступа Zentor (правила по IP, странам и доменам email); отклонённые вызовы получают код 403.

Обзор

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

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

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

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

Параметры

name(body, string, обязательно)— Имя, 2–120 символов
email(body, string, обязательно)— Email-адрес, ранее подтверждённый через `/email/verify`
package(body, string, обязательно)— Пакет: `starter`, `individual` или `demo_access`
company(body, string)— Компания, не более 160 символов (опционально)
phone(body, string)— Номер телефона, не более 40 символов (опционально)
companyWebsite(body, string)— Сайт компании, не более 200 символов (опционально)
paymentMethod(body, string)— Способ оплаты: `paypal`, `kreditkarte`, `rechnung`, `stripe_card` или `stripe_sepa` (опционально)
wish(body, string)— Пожелание: `trial`, `subscription` или `offer`; для `demo_access` всегда `trial` (опционально)
message(body, string)— Сообщение, не более 3000 символов (опционально)

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

{"name":"Иван Иванов","email":"max@example.com","package":"demo_access"}

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

{"ok":false,"error":"EMAIL_NOT_VERIFIED","message":"Пожалуйста, сначала подтвердите свой адрес электронной почты."}

Коды ошибок

400 VALIDATION_ERROR — Отсутствует обязательное поле, либо пакет, способ оплаты или пожелание недействительны.
400 EMAIL_NOT_VERIFIED — Email-адрес не был ранее подтверждён через `/email/start-verification` и `/email/verify`, либо `verification_token` отсутствует или недействителен.

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

Пустое тело возвращает 400 `VALIDATION_ERROR`; действительные данные без подтверждённого email возвращают 400 `EMAIL_NOT_VERIFIED`. Успешный случай следует документированному процессу после подтверждения email.

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

POST /api/public/contactПринимает запрос из контактной формы на сайте Zentor App и передаёт его команде Zentor.POST /api/public/consultationПринимает запрос на консультацию из формы на сайте Zentor App.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озданную учётную запись пользователя и устанавливает первый пароль — запускается по ссылке в приглашающем письме.

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

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