POST/api/public/access-request/email/start-verification

Trimite un cod de confirmare din șase cifre, valabil 10 minute, la adresa de e-mail indicată — primul pas al unei cereri de acces.

Trimiteți adresa de confirmat în câmpul `email`. Răspunsul conține `verification_id`, `expires_in_minutes` (10) și `resend_cooldown_seconds` (60). Folosiți `verification_id` împreună cu aceeași adresă de e-mail și codul primit în `POST /api/public/access-request/email/verify`. Un nou cod poate fi trimis doar după expirarea timpului de așteptare; afișați timpul rămas în interfața dumneavoastră. Dacă limita este depășită, endpointul răspunde cu 429 `RATE_LIMIT_EXCEEDED`. Dacă e-mailul nu poate fi livrat, răspunde cu 502 `MAIL_NOT_SENT`; în acest caz verificați adresa și încercați din nou mai târziu.

Prezentare generală

Apel: POST /api/public/access-request/email/start-verification. Acest endpoint aparține grupului „Formulare publice” al API-ului Zentor App. Este accesibil public și nu necesită autentificare. Apelul nu este idempotent: fiecare apel reușit declanșează din nou acțiunea. Parametri obligatorii: email (body). Cazuri de eroare documentate: 429 RATE_LIMIT_EXCEEDED, 502 MAIL_NOT_SENT. Răspunsul exemplu de mai jos arată structura unui răspuns reușit în format JSON.

Autentificare și securitate

Nu este necesară autentificarea

Cel mult 10 cereri la fiecare 15 minute per adresă IP. Se aplică, de asemenea, regulile de acces ale Zentor (reguli de IP, țară și domeniu de e-mail); apelurile respinse primesc 403.

Limită de rată: 10 Anfragen pro 15 Minuten (IP-basiert)

Idempotent: Nu

Parametri

email(body, string, obligatoriu)— Adresă de e-mail de confirmat

Exemplu de cerere

{"email":"max@example.com"}

Exemplu de răspuns

{"ok":true,"verification_id":"<UUID>","expires_in_minutes":10,"resend_cooldown_seconds":60}

Coduri de eroare

429 RATE_LIMIT_EXCEEDED — Prea multe cereri de la această adresă IP. Așteptați înainte de a solicita un cod nou.
502 MAIL_NOT_SENT — Codul de confirmare nu a putut fi livrat prin e-mail.

Comportament verificat

Apelul returnează 200 cu un `verification_id`, iar codul este trimis prin e-mail; apelurile repetate returnează 429 `RATE_LIMIT_EXCEEDED`.

Formulare publice

POST /api/public/contactPrimește o solicitare din formularul de contact al site-ului Zentor App și o transmite echipei Zentor.POST /api/public/consultationPrimește o solicitare de consultanță din formularul site-ului Zentor App.POST /api/public/access-requestTrimite o cerere de acces pentru un pachet (Starter, Individual sau demo de 14 zile). Este necesară o adresă de e-mail confirmată anterior.POST /api/public/access-request/email/verifyVerifică codul trimis prin e-mail și emite un token de confirmare pentru cererea de acces ulterioară.GET /api/public/access-request/payment-statusIndică ce metode de plată (PayPal, Stripe) sunt disponibile în prezent pentru cererea de acces.GET /api/public/access-request/paypal/configOferă configurația publică PayPal (activ, mod, monedă) pentru pasul de plată.POST /api/public/access-request/paypal/create-orderCreează o comandă PayPal pentru pachetul selectat.POST /api/public/access-request/paypal/capture-orderFinalizează (capturează) o comandă creată anterior și aprobată de cumpărător în checkout-ul PayPal. Suma este stabilită exclusiv de server.POST /api/public/access-request/stripe/create-checkoutCreează o sesiune de checkout Stripe pentru pachetul selectat.POST /api/public/activate-accountActivează un cont de utilizator nou creat și stabilește prima parolă — declanșat prin linkul din e-mailul de invitație.

Articole similare

← Formulare publice