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ów
email(body, string, wymagane)— Prawidłowy adres e-mail
message(body, string, wymagane)— Wiadomość, 10–3000 znaków
company(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.

Powiązane artykuły

← Formularze publiczne