POST/api/public/access-request/email/start-verification
Отправляет шестизначный код подтверждения, действительный 10 минут, на указанный email — первый шаг заявки на доступ.
Отправьте подтверждаемый адрес в поле `email`. Ответ содержит `verification_id`, `expires_in_minutes` (10) и `resend_cooldown_seconds` (60). Используйте `verification_id` вместе с тем же email и полученным кодом в `POST /api/public/access-request/email/verify`. Повторная отправка возможна только после истечения времени ожидания; показывайте оставшееся время в вашем интерфейсе. Если лимит превышен, эндпоинт отвечает кодом 429 `RATE_LIMIT_EXCEEDED`. Если письмо не может быть доставлено, он отвечает кодом 502 `MAIL_NOT_SENT`; в этом случае проверьте адрес и повторите попытку позже.
Обзор
Вызов: POST /api/public/access-request/email/start-verification. Этот эндпоинт относится к группе «Публичные формы» API Zentor App. Он общедоступен и не требует аутентификации. Вызов не идемпотентен: каждый успешный вызов заново запускает действие. Обязательные параметры: email (тело). Задокументированные случаи ошибок: 429 RATE_LIMIT_EXCEEDED, 502 MAIL_NOT_SENT. Пример ответа ниже показывает структуру успешного ответа в формате JSON.
Аутентификация и защита
Аутентификация не требуется
Не более 10 запросов за 15 минут на IP-адрес. Дополнительно действуют правила доступа Zentor (правила по IP, странам и доменам email); отклонённые вызовы получают код 403.
Лимит запросов: 10 Anfragen pro 15 Minuten (IP-basiert)
Идемпотентный: Нет
Параметры
email(body, string, обязательно)— Email-адрес для подтвержденияПример запроса
{"email":"max@example.com"}Пример ответа
{"ok":true,"verification_id":"<UUID>","expires_in_minutes":10,"resend_cooldown_seconds":60}Коды ошибок
429 RATE_LIMIT_EXCEEDED — Слишком много запросов с этого IP-адреса. Подождите, прежде чем запросить новый код.502 MAIL_NOT_SENT — Код подтверждения не удалось доставить по email.Проверенное поведение
Вызов возвращает 200 с `verification_id`, и код доставляется по email; повторные вызовы возвращают 429 `RATE_LIMIT_EXCEEDED`.
Публичные формы
POST /api/public/contactПринимает запрос из контактной формы на сайте Zentor App и передаёт его команде Zentor.POST /api/public/consultationПринимает запрос на консультацию из формы на сайте Zentor App.POST /api/public/access-requestОтправляет заявку на доступ к пакету (Starter, «Индивидуальный» или 14-дневная демоверсия). Требуется предварительно подтверждённый 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озданную учётную запись пользователя и устанавливает первый пароль — запускается по ссылке в приглашающем письме.