POST/api/public/consultation

Odbiera zapytanie o doradztwo z formularza na stronie Zentor App.

Pola wymagane to `name` (2–120 znaków), `email` (prawidłowy adres) oraz `consentGiven`, które musi mieć wartość `true`. Opcjonalnie można przesłać `company`, `phone` i `message`. W przypadku powodzenia serwer odpowiada `{"ok":true}` i komunikatem potwierdzającym; następnie kontaktuje się zespół Zentor. Jeśli brakuje wymaganego pola, jest ono nieprawidłowe lub brak zgody, punkt końcowy odpowiada 400 `VALIDATION_ERROR`. Każde skuteczne wywołanie tworzy nowe zapytanie; wywołanie nie jest więc idempotentne. Maksymalnie 10 żądań na 15 minut na adres IP. Dodatkowo obowiązują reguły dostępu Zentor (reguły IP, kraju i domeny e-mail); odrzucone wywołania otrzymują 403.

Przegląd

Wywołanie: POST /api/public/consultation. Ten endpoint należy do grupy „Formularze publiczne” API Zentor App. Jest publicznie dostępny i nie wymaga uwierzytelniania. Wywołanie nie jest idempotentne: każde udane wywołanie ponownie uruchamia akcję. Parametry wymagane: name (body), email (body), consentGiven (body). Parametry opcjonalne: company (body), message (body), phone (body). Udokumentowane przypadki błędów: 400 VALIDATION_ERROR. Poniższa przykładowa odpowiedź pokazuje strukturę udanej odpowiedzi w formacie JSON.

Uwierzytelnianie i zabezpieczenia

Uwierzytelnianie nie jest wymagane

Idempotentny: Nie

Parametry

name(body, string, wymagane)— Imię i nazwisko, 2–120 znaków
email(body, string, wymagane)— Prawidłowy adres e-mail
company(body, string)— Firma (opcjonalnie)
message(body, string)— Wiadomość (opcjonalnie)
phone(body, string)— Numer telefonu (opcjonalnie)
consentGiven(body, boolean, wymagane)— Zgoda na ochronę danych, musi mieć wartość `true`

Przykładowe żądanie

{"name":"Max Mustermann","email":"max@example.com","company":"Musterfirma","message":"Sprawa","consentGiven":true}

Przykładowa odpowiedź

{"ok":true,"message":"Twoje zapytanie doradcze zostało wysłane. Skontaktujemy się z Tobą wkrótce."}

Kody błędów

400 VALIDATION_ERROR — Brakuje wymaganego pola lub jest ono nieprawidłowe, albo brakuje zgody.

Zweryfikowane zachowanie

Pełne dane zwracają 200; brakujące lub nieprawidłowe dane zwracają 400 `VALIDATION_ERROR`.

Formularze publiczne

POST /api/public/contactOdbiera zapytanie z formularza kontaktowego na stronie Zentor App i przekazuje je zespołowi Zentor.POST /api/public/access-requestSkłada wniosek o dostęp do pakietu (Starter, Indywidualna lub 14-dniowe Demo). Wymagany jest wcześniej potwierdzony adres e-mail.POST /api/public/access-request/email/start-verificationWysyła sześciocyfrowy kod potwierdzający, ważny 10 minut, na podany adres e-mail — pierwszy krok wniosku o dostęp.POST /api/public/access-request/email/verifySprawdza kod wysłany e-mailem i wydaje token potwierdzający na potrzeby kolejnego wniosku o dostęp.GET /api/public/access-request/payment-statusWskazuje, które metody płatności (PayPal, Stripe) są aktualnie dostępne dla wniosku o dostęp.GET /api/public/access-request/paypal/configZwraca publiczną konfigurację PayPal (aktywność, tryb, walutę) na potrzeby etapu płatności.POST /api/public/access-request/paypal/create-orderTworzy zamówienie PayPal dla wybranego pakietu.POST /api/public/access-request/paypal/capture-orderFinalizuje (capture) wcześniej utworzone i zatwierdzone przez kupującego w kasie PayPal zamówienie. Kwotę ustala wyłącznie serwer.POST /api/public/access-request/stripe/create-checkoutTworzy sesję Stripe Checkout dla wybranego pakietu.POST /api/public/activate-accountAktywuje nowo utworzone konto użytkownika i ustawia pierwsze hasło — wywołane przez odnośnik w e-mailu z zaproszeniem.

Powiązane artykuły

← Formularze publiczne