POST/api/public/contact

Riceve una richiesta dal modulo di contatto del sito web di Zentor App e la inoltra al team Zentor.

I campi obbligatori sono `name` (2–120 caratteri), `email` (indirizzo e-mail valido), `message` (10–3000 caratteri) e `consentGiven`, che deve essere impostato su `true`. Facoltativamente si possono inviare `company`, `phone` e `topic`. In caso di successo il server risponde con `{"ok":true}` e un messaggio di conferma. Se manca un campo obbligatorio, non è valido o manca il consenso, l'endpoint risponde 400 `VALIDATION_ERROR`; il campo `details` elenca i singoli errori, così da poter segnalare i campi interessati. Ogni invio riuscito crea una nuova richiesta. Disattivate quindi il pulsante di invio fino alla risposta e non ripetete 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/contact. 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), message (body), consentGiven (body). Parametri facoltativi: company (body), phone (body), topic (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
message(body, string, obbligatorio)— Messaggio, 10–3000 caratteri
company(body, string)— Azienda (opzionale)
phone(body, string)— Numero di telefono (opzionale)
topic(body, string)— Oggetto della richiesta (opzionale)
consentGiven(body, boolean, obbligatorio)— Consenso alla protezione dei dati, deve essere `true`

Richiesta di esempio

{"name":"Max Mustermann","email":"max@example.com","message":"Il vostro messaggio (min. 10 caratteri).","consentGiven":true}

Risposta di esempio

{"ok":true,"message":"Ihre Anfrage wurde übermittelt."}

Codici di errore

400 VALIDATION_ERROR — Manca un campo obbligatorio o non è valido, oppure manca il consenso alla protezione dei dati. `details` contiene i singoli messaggi di errore.

Comportamento verificato

Dati completi restituiscono 200; campi obbligatori mancanti o consenso mancante restituiscono 400 `VALIDATION_ERROR`.

Moduli pubblici

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