POST/api/public/contact
Odbiera zapytanie z formularza kontaktowego na stronie Zentor App i przekazuje je zespołowi Zentor.
Pola wymagane to `name` (2–120 znaków), `email` (prawidłowy adres e-mail), `message` (10–3000 znaków) oraz `consentGiven`, które musi mieć wartość `true`. Opcjonalnie można przesłać `company`, `phone` i `topic`. W przypadku powodzenia serwer odpowiada `{"ok":true}` i komunikatem potwierdzającym. Jeśli brakuje wymaganego pola, jest ono nieprawidłowe lub brak zgody, punkt końcowy odpowiada 400 `VALIDATION_ERROR`; pole `details` zawiera listę poszczególnych błędów, dzięki czemu można oznaczyć odpowiednie pola. Każde skuteczne wysłanie tworzy nowe zapytanie. Dlatego blokują Państwo przycisk wysyłania do czasu otrzymania odpowiedzi i nie powtarzają wywołania automatycznie. 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/contact. 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), message (body), consentGiven (body). Parametry opcjonalne: company (body), phone (body), topic (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-mailmessage(body, string, wymagane)— Wiadomość, 10–3000 znakówcompany(body, string)— Firma (opcjonalnie)phone(body, string)— Numer telefonu (opcjonalnie)topic(body, string)— Temat zapytania (opcjonalnie)consentGiven(body, boolean, wymagane)— Zgoda na ochronę danych, musi mieć wartość `true`Przykładowe żądanie
{"name":"Max Mustermann","email":"max@example.com","message":"Twoja wiadomość (min. 10 znaków).","consentGiven":true}Przykładowa odpowiedź
{"ok":true,"message":"Twoje zapytanie zostało wysłane."}Kody błędów
400 VALIDATION_ERROR — Brakuje wymaganego pola lub jest ono nieprawidłowe, albo brakuje zgody na ochronę danych. `details` zawiera poszczególne komunikaty błędów.Zweryfikowane zachowanie
Pełne dane zwracają 200; brak wymaganych pól lub brak zgody zwraca 400 `VALIDATION_ERROR`.
Formularze publiczne
POST /api/public/consultationOdbiera zapytanie o doradztwo z formularza na stronie Zentor App.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.