POST/api/public/consultation
Приймає запит на консультацію з форми на сайті Zentor App.
Обов’язкові поля: `name` (2–120 символів), `email` (дійсна email-адреса) і `consentGiven`, яке має бути встановлено на `true`. Опціонально можна надіслати `company`, `phone` і `message`. У разі успіху сервер відповідає `{"ok":true}` і повідомленням підтвердження; після цього команда Zentor зв’яжеться з вами. Якщо обов’язкове поле відсутнє, недійсне або відсутня згода, кінцевий пункт відповідає кодом 400 `VALIDATION_ERROR`. Кожен успішний виклик створює новий запит, тому виклик не ідемпотентний. Не більше 10 запитів за 15 хвилин на IP-адресу. Додатково діють правила доступу Zentor (правила за IP, країнами та доменами email); відхилені виклики отримують код 403.
Огляд
Виклик: POST /api/public/consultation. Цей ендпоінт належить до групи «Публічні форми» API Zentor App. Він загальнодоступний і не потребує автентифікації. Виклик не ідемпотентний: кожен успішний виклик знову запускає дію. Обов’язкові параметри: name (тіло), email (тіло), consentGiven (тіло). Необов’язкові параметри: company (тіло), message (тіло), phone (тіло). Задокументовані випадки помилок: 400 VALIDATION_ERROR. Приклад відповіді нижче показує структуру успішної відповіді у форматі JSON.
Автентифікація та захист
Автентифікація не потрібна
Ідемпотентний: Ні
Параметри
name(body, string, обов'язково)— Ім’я, 2–120 символівemail(body, string, обов'язково)— Дійсна email-адресаcompany(body, string)— Компанія (опціонально)message(body, string)— Повідомлення (опціонально)phone(body, string)— Номер телефону (опціонально)consentGiven(body, boolean, обов'язково)— Згода на обробку даних, має бути `true`Приклад запиту
{"name":"Max Mustermann","email":"max@example.com","company":"Musterfirma","message":"Питання","consentGiven":true}Приклад відповіді
{"ok":true,"message":"Ваш запит на консультацію надіслано. Ми зв'яжемося з вами найближчим часом."}Коди помилок
400 VALIDATION_ERROR — Обов’язкове поле відсутнє або недійсне, або відсутня згода.Перевірена поведінка
Повні дані повертають 200; відсутні або недійсні дані повертають 400 `VALIDATION_ERROR`.
Публічні форми
POST /api/public/contactПриймає запит із контактної форми на сайті Zentor App і передає його команді Zentor.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ковий запис користувача і встановлює перший пароль — запускається за посиланням у листі-запрошенні.