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 — Код підтвердження не вдалося доставити електронною поштою.

Перевірена поведінка

Виклик повертає 200 з `verification_id`, і код надсилається електронною поштою; повторні виклики повертають 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Перевіряє код, доставлений електронною поштою, і видає токен підтвердження для подальшої заявки на доступ.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Активує новостворений облiковий запис користувача і встановлює перший пароль — запускається за посиланням у листі-запрошенні.

Споріднені статті

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