POST/api/public/access-request
Składa wniosek o dostęp do pakietu (Starter, Indywidualna lub 14-dniowe Demo). Wymagany jest wcześniej potwierdzony adres e-mail.
Najpierw potwierdźcie adres e-mail przez `POST /api/public/access-request/email/start-verification` i `POST /api/public/access-request/email/verify`. Następnie wyślijcie `name`, ten sam `email`, pakiet `package` (`starter`, `individual` lub `demo_access`) oraz otrzymany `verification_token`. Opcjonalnie można przesłać `company`, `phone`, `companyWebsite`, `paymentMethod` (`paypal`, `kreditkarte`, `rechnung`, `stripe_card` lub `stripe_sepa`), `wish` (`trial`, `subscription` lub `offer`; dla dostępu demo zawsze `trial`) i `message`. Bez prawidłowego potwierdzenia serwer odpowiada 400 `EMAIL_NOT_VERIFIED`. Brak wymaganych pól lub nieprawidłowe wartości pakietu, metody płatności lub życzenia prowadzą do 400 `VALIDATION_ERROR`. Każde skuteczne zgłoszenie jest tworzone jako nowe zgłoszenie i przetwarzane przez Zentor; nie powtarzajcie więc 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/access-request. 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), package (body). Parametry opcjonalne: company (body), phone (body), companyWebsite (body), paymentMethod (body), wish (body), message (body). Udokumentowane przypadki błędów: 400 VALIDATION_ERROR, 400 EMAIL_NOT_VERIFIED. 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)— Adres e-mail potwierdzony wcześniej przez `/email/verify`package(body, string, wymagane)— Pakiet: `starter`, `individual` lub `demo_access`company(body, string)— Firma, maks. 160 znaków (opcjonalnie)phone(body, string)— Numer telefonu, maks. 40 znaków (opcjonalnie)companyWebsite(body, string)— Strona internetowa firmy, maks. 200 znaków (opcjonalnie)paymentMethod(body, string)— Metoda płatności: `paypal`, `kreditkarte`, `rechnung`, `stripe_card` lub `stripe_sepa` (opcjonalnie)wish(body, string)— Życzenie: `trial`, `subscription` lub `offer`; dla `demo_access` zawsze `trial` (opcjonalnie)message(body, string)— Wiadomość, maks. 3000 znaków (opcjonalnie)Przykładowe żądanie
{"name":"Jan Kowalski","email":"max@example.com","package":"demo_access"}Przykładowa odpowiedź
{"ok":false,"error":"EMAIL_NOT_VERIFIED","message":"Najpierw potwierdź swój adres e-mail."}Kody błędów
400 VALIDATION_ERROR — Brakuje wymaganego pola, albo pakiet, metoda płatności lub życzenie są nieprawidłowe.400 EMAIL_NOT_VERIFIED — Adres e-mail nie został wcześniej potwierdzony przez `/email/start-verification` i `/email/verify`, albo `verification_token` jest brak lub nieprawidłowy.Zweryfikowane zachowanie
Pusta treść zwraca 400 `VALIDATION_ERROR`; prawidłowe dane bez potwierdzonego adresu e-mail zwracają 400 `EMAIL_NOT_VERIFIED`. Przypadek sukcesu przebiega zgodnie z udokumentowanym procesem po potwierdzeniu e-maila.
Formularze publiczne
POST /api/public/contactOdbiera zapytanie z formularza kontaktowego na stronie Zentor App i przekazuje je zespołowi Zentor.POST /api/public/consultationOdbiera zapytanie o doradztwo z formularza na stronie Zentor App.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.