POST/api/public/access-request/email/start-verification
Odošle šesťmiestny potvrdzovací kód platný 10 minút na uvedenú e-mailovú adresu – prvý krok žiadosti o prístup.
Odošlite adresu na potvrdenie v poli `email`. Odpoveď obsahuje `verification_id`, `expires_in_minutes` (10) a `resend_cooldown_seconds` (60). Použite `verification_id` spolu s rovnakou e-mailovou adresou a získaným kódom v `POST /api/public/access-request/email/verify`. Nový kód možno odoslať až po uplynutí čakacej doby; zobrazte zostávajúci čas vo svojom rozhraní. Pri prekročení limitu endpoint odpovie 429 `RATE_LIMIT_EXCEEDED`. Ak e-mail nemožno doručiť, odpovie 502 `MAIL_NOT_SENT`; v takom prípade skontrolujte adresu a skúste to neskôr znova.
Prehľad
Volanie: POST /api/public/access-request/email/start-verification. Tento endpoint patrí do skupiny „Verejné formuláre“ API aplikácie Zentor App. Je verejne dostupný a nevyžaduje žiadnu autentifikáciu. Volanie nie je idempotentné: Každé úspešné volanie akciu spustí znova. Povinné parametre: email (body). Zdokumentované chybové prípady: 429 RATE_LIMIT_EXCEEDED, 502 MAIL_NOT_SENT. Ukážková odpoveď nižšie zobrazuje štruktúru úspešnej odpovede vo formáte JSON.
Autentifikácia a zabezpečenie
Nevyžaduje sa žiadna autentifikácia
Najviac 10 požiadaviek za 15 minút na jednu IP adresu. Navyše platia prístupové pravidlá Zentor (pravidlá IP, krajiny a e-mailovej domény); odmietnuté požiadavky dostanú 403.
Limit požiadaviek (rate limit): 10 Anfragen pro 15 Minuten (IP-basiert)
Idempotentné: Nie
Parametre
email(body, string, povinné)— E-mailová adresa na potvrdeniePríklad požiadavky
{"email":"max@example.com"}Príklad odpovede
{"ok":true,"verification_id":"<UUID>","expires_in_minutes":10,"resend_cooldown_seconds":60}Chybové kódy
429 RATE_LIMIT_EXCEEDED — Príliš mnoho požiadaviek z tejto IP adresy. Počkajte, než si vyžiadate nový kód.502 MAIL_NOT_SENT — Potvrdzovací kód sa nepodarilo doručiť e-mailom.Overené správanie
Volanie vráti 200 s `verification_id` a kód sa doručí e-mailom; opakované volania vrátia 429 `RATE_LIMIT_EXCEEDED`.
Verejné formuláre
POST /api/public/contactPrijíma dotaz z kontaktného formulára na webe Zentor App a odovzdáva ho tímu Zentor.POST /api/public/consultationPrijíma žiadosť o poradenstvo z formulára na webe Zentor App.POST /api/public/access-requestOdošle žiadosť o prístup k balíku (Starter, Individuálny alebo 14-dňové Demo). Vyžaduje sa predtým potvrdená e-mailová adresa.POST /api/public/access-request/email/verifySkontroluje kód doručený e-mailom a vydá potvrdzovací token pre následnú žiadosť o prístup.GET /api/public/access-request/payment-statusUdáva, ktoré platobné metódy (PayPal, Stripe) sú aktuálne dostupné pre žiadosť o prístup.GET /api/public/access-request/paypal/configVracia verejnú konfiguráciu PayPal (aktívne, režim, mena) pre platobný krok.POST /api/public/access-request/paypal/create-orderVytvorí objednávku PayPal pre vybraný balík.POST /api/public/access-request/paypal/capture-orderDokončí (capture) predtým vytvorenú objednávku schválenú kupujúcim v checkoute PayPal. Sumu určuje výhradne server.POST /api/public/access-request/stripe/create-checkoutVytvorí platobnú relaciu Stripe Checkout pre vybraný balík.POST /api/public/activate-accountAktivuje novo vytvorený používateľský účet a nastaví prvé heslo – spustené cez odkaz v pozývacom e-maile.