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

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

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