POST/api/public/consultation

Riceve una richiesta di consulenza dal modulo del sito web di Zentor App.

I campi obbligatori sono `name` (2–120 caratteri), `email` (indirizzo valido) e `consentGiven`, che deve essere `true`. Facoltativamente si possono inviare `company`, `phone` e `message`. In caso di successo il server risponde con `{"ok":true}` e un messaggio di conferma; il team Zentor vi contatterà poi. Se manca un campo obbligatorio, non è valido o manca il consenso, l'endpoint risponde 400 `VALIDATION_ERROR`. Ogni chiamata riuscita crea una nuova richiesta; la chiamata non è quindi idempotente. 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/consultation. 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), consentGiven (body). Parametri facoltativi: company (body), message (body), phone (body). Casi di errore documentati: 400 VALIDATION_ERROR. 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 valido
company(body, string)— Azienda (opzionale)
message(body, string)— Messaggio (opzionale)
phone(body, string)— Numero di telefono (opzionale)
consentGiven(body, boolean, obbligatorio)— Consenso alla protezione dei dati, deve essere `true`

Richiesta di esempio

{"name":"Max Mustermann","email":"max@example.com","company":"Musterfirma","message":"Richiesta","consentGiven":true}

Risposta di esempio

{"ok":true,"message":"Ihre Beratungsanfrage wurde übermittelt. Wir melden uns in Kürze bei Ihnen."}

Codici di errore

400 VALIDATION_ERROR — Manca un campo obbligatorio o non è valido, oppure manca il consenso.

Comportamento verificato

Dati completi restituiscono 200; dati mancanti o non validi restituiscono 400 `VALIDATION_ERROR`.

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