POST/api/public/access-request/email/verify

Verifica il codice inviato per e-mail e rilascia un token di conferma per la successiva richiesta di accesso.

Inviate `verification_id` (da `start-verification`), la stessa `email` e il `code` a sei cifre. In caso di successo, la risposta contiene `verified: true` e un `verification_token` che inviate quando presentate la richiesta di accesso tramite `POST /api/public/access-request`. Un codice errato o scaduto, un `verification_id` non corrispondente o un indirizzo e-mail diverso comportano 400 `VERIFY_FAILED`. In tal caso richiedete un nuovo codice. Il token è valido solo per questo indirizzo e-mail e non deve apparire in URL o log. Al massimo 10 richieste ogni 15 minuti per indirizzo IP.

Panoramica

Chiamata: POST /api/public/access-request/email/verify. 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: verification_id (body), email (body), code (body). Casi di errore documentati: 400 VERIFY_FAILED. La risposta di esempio riportata di seguito mostra la struttura di una risposta riuscita in formato JSON.

Autenticazione e sicurezza

Nessuna autenticazione richiesta

Idempotente: No

Parametri

verification_id(body, string, obbligatorio)— `verification_id` da `start-verification`
email(body, string, obbligatorio)— Lo stesso indirizzo e-mail usato per richiedere il codice
code(body, string, obbligatorio)— Codice a sei cifre dall'e-mail

Richiesta di esempio

{"verification_id":"<UUID>","email":"max@example.com","code":"123456"}

Risposta di esempio

{"ok":true,"verified":true,"verification_token":"<Token per la successiva richiesta accesso>"}

Codici di errore

400 VERIFY_FAILED — Il codice, il `verification_id` o l'indirizzo e-mail sono errati, oppure il codice è scaduto.

Comportamento verificato

Un codice errato restituisce 400 `VERIFY_FAILED`. Il caso di successo corrisponde alla conferma via e-mail del configuratore di prodotto.

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/start-verificationInvia un codice di conferma a sei cifre, valido 10 minuti, all'indirizzo e-mail indicato — il primo passo di una 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