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 potwierdzenia

Przykł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.

Powiązane artykuły

← Formularze publiczne