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

Invia un codice di conferma a sei cifre, valido 10 minuti, all'indirizzo e-mail indicato — il primo passo di una richiesta di accesso.

Inviate l'indirizzo da confermare nel campo `email`. La risposta contiene `verification_id`, `expires_in_minutes` (10) e `resend_cooldown_seconds` (60). Usate `verification_id` insieme allo stesso indirizzo e-mail e al codice ricevuto in `POST /api/public/access-request/email/verify`. Un nuovo invio è possibile solo dopo la scadenza del tempo di attesa; mostrate il tempo rimanente nella vostra interfaccia. Se il limite viene superato, l'endpoint risponde 429 `RATE_LIMIT_EXCEEDED`. Se l'e-mail non può essere consegnata, risponde 502 `MAIL_NOT_SENT`; in tal caso verificate l'indirizzo e riprovate più tardi.

Panoramica

Chiamata: POST /api/public/access-request/email/start-verification. Questo endpoint appartiene al gruppo «Moduli pubblici» dell'API di Zentor App. È accessibile pubblicamente e non richiede autenticazione. La chiamata non è idempotente: ogni chiamata riuscita attiva nuovamente l'azione. Parametri obbligatori: email (body). Casi di errore documentati: 429 RATE_LIMIT_EXCEEDED, 502 MAIL_NOT_SENT. La risposta di esempio riportata di seguito mostra la struttura di una risposta riuscita in formato JSON.

Autenticazione e sicurezza

Nessuna autenticazione richiesta

Al massimo 10 richieste ogni 15 minuti per indirizzo IP. Si applicano inoltre le regole di accesso di Zentor (regole su IP, paese e dominio e-mail); le chiamate rifiutate ricevono 403.

Limite di richieste: 10 Anfragen pro 15 Minuten (IP-basiert)

Idempotente: No

Parametri

email(body, string, obbligatorio)— Indirizzo e-mail da confermare

Richiesta di esempio

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

Risposta di esempio

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

Codici di errore

429 RATE_LIMIT_EXCEEDED — Troppe richieste da questo indirizzo IP. Attendete prima di richiedere un nuovo codice.
502 MAIL_NOT_SENT — Il codice di conferma non è stato consegnato per e-mail.

Comportamento verificato

La chiamata restituisce 200 con un `verification_id`, e il codice viene inviato per e-mail; le chiamate ripetute restituiscono 429 `RATE_LIMIT_EXCEEDED`.

Moduli pubblici

POST /api/public/contactRiceve una richiesta dal modulo di contatto del sito web di Zentor App e la inoltra al team Zentor.POST /api/public/consultationRiceve una richiesta di consulenza dal modulo del sito web di Zentor App.POST /api/public/access-requestInoltra una richiesta di accesso per un pacchetto (Starter, Individuale o demo di 14 giorni). È necessario un indirizzo e-mail precedentemente confermato.POST /api/public/access-request/email/verifyVerifica il codice inviato per e-mail e rilascia un token di conferma per la successiva richiesta di accesso.GET /api/public/access-request/payment-statusIndica quali metodi di pagamento (PayPal, Stripe) sono attualmente disponibili per la richiesta di accesso.GET /api/public/access-request/paypal/configRestituisce la configurazione pubblica di PayPal (attivo, modalità, valuta) per la fase di pagamento.POST /api/public/access-request/paypal/create-orderCrea un ordine PayPal per il pacchetto selezionato.POST /api/public/access-request/paypal/capture-orderCompleta (capture) un ordine precedentemente creato e approvato dall'acquirente nel checkout PayPal. L'importo è determinato esclusivamente dal server.POST /api/public/access-request/stripe/create-checkoutCrea una sessione di checkout Stripe per il pacchetto selezionato.POST /api/public/activate-accountAttiva un account utente appena creato e imposta la prima password, avviato tramite il link nell'e-mail di invito.

Articoli correlati

← Moduli pubblici