POST/api/public/access-request

Inoltra una richiesta di accesso per un pacchetto (Starter, Individuale o demo di 14 giorni). È necessario un indirizzo e-mail precedentemente confermato.

Confermate prima l'indirizzo e-mail tramite `POST /api/public/access-request/email/start-verification` e `POST /api/public/access-request/email/verify`. Inviate poi `name`, la stessa `email`, il pacchetto `package` (`starter`, `individual` o `demo_access`) e il `verification_token` ricevuto. Facoltativamente si possono inviare `company`, `phone`, `companyWebsite`, `paymentMethod` (`paypal`, `kreditkarte`, `rechnung`, `stripe_card` o `stripe_sepa`), `wish` (`trial`, `subscription` o `offer`; sempre `trial` per l'accesso demo) e `message`. Senza una conferma valida, il server risponde 400 `EMAIL_NOT_VERIFIED`. Campi obbligatori mancanti o valori non validi per pacchetto, metodo di pagamento o richiesta comportano 400 `VALIDATION_ERROR`. Ogni richiesta riuscita viene creata come nuova richiesta e gestita da Zentor; non ripetete quindi la chiamata automaticamente. 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.

Panoramica

Chiamata: POST /api/public/access-request. 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: name (body), email (body), package (body). Parametri facoltativi: company (body), phone (body), companyWebsite (body), paymentMethod (body), wish (body), message (body). Casi di errore documentati: 400 VALIDATION_ERROR, 400 EMAIL_NOT_VERIFIED. 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

name(body, string, obbligatorio)— Nome, 2–120 caratteri
email(body, string, obbligatorio)— Indirizzo e-mail precedentemente confermato tramite `/email/verify`
package(body, string, obbligatorio)— Pacchetto: `starter`, `individual` o `demo_access`
company(body, string)— Azienda, max. 160 caratteri (opzionale)
phone(body, string)— Numero di telefono, max. 40 caratteri (opzionale)
companyWebsite(body, string)— Sito web dell'azienda, max. 200 caratteri (opzionale)
paymentMethod(body, string)— Metodo di pagamento: `paypal`, `kreditkarte`, `rechnung`, `stripe_card` o `stripe_sepa` (opzionale)
wish(body, string)— Richiesta: `trial`, `subscription` o `offer`; sempre `trial` per `demo_access` (opzionale)
message(body, string)— Messaggio, max. 3000 caratteri (opzionale)

Richiesta di esempio

{"name":"Mario Rossi","email":"max@example.com","package":"demo_access"}

Risposta di esempio

{"ok":false,"error":"EMAIL_NOT_VERIFIED","message":"Bitte bestätigen Sie zuerst Ihre E-Mail-Adresse."}

Codici di errore

400 VALIDATION_ERROR — Manca un campo obbligatorio, oppure il pacchetto, il metodo di pagamento o la richiesta non sono validi.
400 EMAIL_NOT_VERIFIED — L'indirizzo e-mail non è stato confermato precedentemente tramite `/email/start-verification` e `/email/verify`, oppure il `verification_token` è mancante o non valido.

Comportamento verificato

Un corpo vuoto restituisce 400 `VALIDATION_ERROR`; dati validi senza indirizzo e-mail confermato restituiscono 400 `EMAIL_NOT_VERIFIED`. Il caso di successo segue il flusso documentato dopo la conferma dell'e-mail.

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