SPECIFICHE DELLA PIATTAFORMA · CAPACITÀ E CONFINI

Caratteristiche autorevoli, confini operativi chiari.

Lugatu è progettato attorno a veri e propri limiti operativi: zero configurazione SMTP in uscita, persistenza durevole del database prima delle notifiche e contabilità trasparente delle quote. Esamina i nostri set di funzionalità verificati, i limiti di sistema e le invarianti architettoniche di seguito.

1. Ingestione di moduli e architettura di pubblicazione

Lugatu supporta tre distinti modelli di acquisizione progettati per bilanciare la rapida implementazione con la sicurezza aziendale: (1) moduli ospitati indipendenti senza dominio con permalink pubblici puliti (https://www.lugatu.com/f/{slug}) che non richiedono alcuna configurazione del dominio; (2) Endpoint dei moduli statici lato client per HTML5, React, Next.js e Astro; e (3) API REST di inserimento da server a server autenticata tramite chiavi API private (POST /api/v1/forms/{formId}/submissions).

info

Ogni modulo supporta la modalità istantanea che alterna la modalità di richiesta standard alla modalità sondaggio con impaginazione in più passaggi, reindirizzamenti di completamento personalizzati e controlli automatizzati della capacità delle liste di attesa.

server-to-server-ingestion.sh bash
curl -X POST https://www.lugatu.com/api/v1/forms/FORM_ID/submissions \
  -H "Authorization: Bearer lug_live_01923456789abcdef0123456789abcde" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: lug_idem_01923456789a7b3fb3a1123456789abc" \
  -d '{"fields":{"name":"Alex Morgan","email":"alex@example.com","message":"Technical inquiry"}}'
Le chiamate da server a server aggirano CORS e i blocchi di origine del browser, autenticate in modo sicuro con token Bearer.

2. Architettura delle quote e limiti delle notifiche via e-mail

L'invio delle notifiche avviene rigorosamente tramite modulo (OFF, INSTANT, DAILY_SUMMARY, WEEKLY_SUMMARY). Ciascun dominio principale verificato in modo indipendente (eTLD+1) riceve 500 consegne di posta elettronica in uscita per mese di calendario UTC, condivise tra tutti i sottodomini, con un massimo di 2 caselle di posta di destinazione verificate. A differenza dei servizi di moduli legacy che scartano i lead una volta raggiunti i limiti di posta elettronica, Lugatu affida atomicamente ogni risposta legittima a PostgreSQL: l'esaurimento della quota contrassegna le notifiche come SuppressedByQuota preservando in modo sicuro la richiesta nella posta in arrivo centrale.

warning

Per preservare la reputazione della piattaforma e prevenire abusi di spam, i moduli autonomi senza dominio archiviano gli invii direttamente nella posta in arrivo del dashboard senza l'invio di e-mail in uscita finché non viene connesso un dominio root personalizzato autenticato.

3. Persistenza dei dati, concorrenza e capacità di esportazione

Non sono previsti limiti artificiali al conteggio delle risposte mensili sui moduli ordinari legittimi o sull'invio di sondaggi durante la beta pubblica. Gli invii in entrata sono sottoposti a persistenza atomica transazionale con prevenzione dei duplicati tramite chiavi di idempotenza client o server (lug_idem_...). I membri dell'area di lavoro possono esportare gli invii filtrati in CSV o JSON UTF-8 in qualsiasi momento. I valori dei campi supportano fino a 64 KB per singolo campo, con il corpo della richiesta totale limitato a 1 MB nel gateway API.

tip

Le chiavi di idempotenza eliminano i record duplicati causati dai tentativi sulla rete mobile: il nuovo invio con la chiave identica restituisce HTTP 200 OK con isDuplicate: true e l'ID di invio originale senza contatori a doppio incremento.

4. Architettura di sicurezza, honeypot e verifica dell'origine

Lugatu applica una difesa dagli abusi a più livelli: (1) campi honeypot invisibili e intelligenti che intercettano i raschiatori di moduli automatizzati senza CAPTCHA dell'utente; (2) Verifica del bot Turnstile di Cloudflare per moduli pubblici ad alto rischio; (3) Controlli rigorosi dell'origine del browser che rifiutano le chiavi API da server a server (lug_live_...) con HTTP 403 FORBIDDEN_BROWSER_ORIGIN; e (4) Limitazione della velocità per IP client ed endpoint di invio.

5. Autenticazione, Nonces e impegni in materia di privacy

Gli utenti si autenticano tramite email e password verificate o Google Identity Services (GIS). Lugatu memorizza solo l'identificatore oggetto stabile di Google (sub), l'e-mail verificata e il nome del profilo. I token di accesso OAuth grezzi e le password esterne non vengono mai richiesti o archiviati. I nonce dello stato OAuth scadono dopo 5 minuti e sono rigorosamente monouso. Lugatu opera secondo impegni verificati di privacy pari a zero vendite e zero pubblicità: i dati di chi invia i moduli non vengono mai profilati, venduti o riproposti.

Invariante di sicurezza e autenticazione

Invariante tecnica: le chiavi API server-to-server (lug_live_...) non devono mai essere incorporate in HTML, JavaScript o repository pubblici lato client. Le richieste del browser contenenti chiavi live vengono bloccate automaticamente.

Risoluzione dei problemi ed errori comuni di importazione

Notifica contrassegnata come SuppressedByQuota

Il tuo dominio principale verificato ha inviato tutte le 500 unità email mensili. Le richieste vengono archiviate in modo sicuro nella posta in arrivo della dashboard e le notifiche riprendono nel mese di calendario UTC successivo.

HTTP 403 FORBIDDEN_BROWSER_ORIGIN

Una chiave API privata (lug_live_...) è stata inviata da un'origine browser pubblica. Utilizza l'endpoint client pubblico (/api/v1/public/forms/...) o gli invii proxy tramite il server back-end.

Notifiche e-mail non inviate per moduli autonomi

I moduli autonomi senza dominio acquisiscono gli invii direttamente nella casella di posta della dashboard senza recapito di posta elettronica esterna. Aggiungi e verifica un dominio root personalizzato per abilitare gli avvisi e-mail in uscita.

L'invio duplicato restituisce HTTP 200

L'invio conteneva una chiave di idempotenza corrispondente a un record esistente. Lugatu ha restituito in modo sicuro l'ID di invio originale con isDuplicate: true senza creare duplicati.

Domande frequenti

Cosa succede quando viene raggiunto il limite di 500 email mensili?

Lugatu non cancella né rilascia mai i tuoi contributi. Ogni richiesta rimane ricercabile e accessibile nella tua casella di posta. Solo l'invio di email viene temporaneamente sospeso fino al mese di calendario successivo.

Posso utilizzare Lugatu senza possedere un sito web o un dominio personalizzato?

SÌ. I moduli ospitati senza dominio (https://www.lugatu.com/f/{slug}) ti consentono di condividere istantaneamente moduli o sondaggi reattivi tramite collegamento diretto, biografia social o codice QR con persistenza completa della casella di posta del dashboard.

Sono previsti limiti mensili per il conteggio delle risposte?

Durante la beta pubblica non viene imposto alcun limite commerciale al conteggio delle risposte mensili per l'utilizzo legittimo dei moduli ordinari e dei sondaggi.

Come funziona la condivisione delle quote del dominio root?

Quando verifichi example.com, tutti i sottodomini (app.example.com, shop.example.com) e i moduli associati condividono la singola quota mensile di 500 email, con un massimo di due indirizzi di destinazione verificati.

Pronto per creare l'endpoint del modulo?

Inizia gratuitamente in pochi secondi. Nessuna carta di credito richiesta.

Inizia gratis →