POST/api/public/access-request/email/start-verification
Wysyła sześciocyfrowy kod potwierdzający, ważny 10 minut, na podany adres e-mail — pierwszy krok wniosku o dostęp.
Wyślijcie adres do potwierdzenia w polu `email`. Odpowiedź zawiera `verification_id`, `expires_in_minutes` (10) i `resend_cooldown_seconds` (60). Użyjcie `verification_id` wraz z tym samym adresem e-mail i otrzymanym kodem w `POST /api/public/access-request/email/verify`. Nowy kod można wysłać dopiero po upływie czasu oczekiwania; pokażcie pozostały czas w swoim interfejsie. Jeśli limit zostanie przekroczony, punkt końcowy odpowiada 429 `RATE_LIMIT_EXCEEDED`. Jeśli e-mail nie może zostać dostarczony, odpowiada 502 `MAIL_NOT_SENT`; w takim przypadku sprawdźcie adres i spróbujcie ponownie później.
Przegląd
Wywołanie: POST /api/public/access-request/email/start-verification. 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: email (body). Udokumentowane przypadki błędów: 429 RATE_LIMIT_EXCEEDED, 502 MAIL_NOT_SENT. Poniższa przykładowa odpowiedź pokazuje strukturę udanej odpowiedzi w formacie JSON.
Uwierzytelnianie i zabezpieczenia
Uwierzytelnianie nie jest wymagane
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.
Limit żądań: 10 Anfragen pro 15 Minuten (IP-basiert)
Idempotentny: Nie
Parametry
email(body, string, wymagane)— Adres e-mail do potwierdzeniaPrzykładowe żądanie
{"email":"max@example.com"}Przykładowa odpowiedź
{"ok":true,"verification_id":"<UUID>","expires_in_minutes":10,"resend_cooldown_seconds":60}Kody błędów
429 RATE_LIMIT_EXCEEDED — Za dużo żądań z tego adresu IP. Proszę czekać przed poproszeniem o nowy kod.502 MAIL_NOT_SENT — Nie udało się dostarczyć kodu potwierdzającego e-mailem.Zweryfikowane zachowanie
Wywołanie zwraca 200 z `verification_id`, a kod jest dostarczany e-mailem; powtarzane wywołania zwracają 429 `RATE_LIMIT_EXCEEDED`.
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-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/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.