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

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

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