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ówemail(body, string, wymagane)— Prawidłowy adres e-mailcompany(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.