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 caratteriemail(body, string, obbligatorio)— Indirizzo e-mail validomessage(body, string, obbligatorio)— Messaggio, 10–3000 carattericompany(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.