Come pubblicare in sicurezza le risposte dei form sul tuo sito
Una richiesta comune: “Voglio mostrare un elenco di iscritti sul nostro sito” oppure “Mi servono le risposte nel mio pannello di amministrazione”. La REST API lo permette, e la differenza tra un’implementazione sicura e una non sicura dipende da una sola cosa: dove si trova la chiave API.
Da sapere: l'editor e l'account di Gatherino sono disponibili in inglese o ceco. I moduli compilati dai tuoi rispondenti possono essere mostrati in 18 lingue, inclusa questa.
La regola di base
La chiave API deve stare sul tuo server, mai nel JavaScript del browser. Se inserisci la chiave nel codice front-end, chiunque può leggerla dal sorgente della pagina e scaricare ogni risposta di ogni tuo form, non solo quelle che intendevi mostrare.
Il flusso corretto è questo: il browser chiede al tuo server → il tuo server chiede a Gatherino usando la chiave → il tuo server restituisce solo i campi che devono essere pubblici.
La parte lato server
Recupero delle risposte sul backend (Node.js):
const res = await fetch(
`https://gatherino.com/api/v1/submissions?formId=${FORM_ID}&limit=100`,
{ headers: { Authorization: `Bearer ${process.env.GATHERINO_KEY}` } }
);
const { items, total, totalPages } = await res.json();
// Publish selected fields only — never the whole data object
const publicList = items.map((s) => ({
name: s.data[FIELD_NAME_ID],
city: s.data[FIELD_CITY_ID],
}));I passaggi
- 1
Crea una chiave API
Vai su Impostazioni → Chiavi API. Viene mostrata una sola volta, quindi conservala in una variabile d’ambiente lato server.
- 2
Trova gli ID dei campi
L’endpoint di dettaglio del form restituisce l’ID e l’etichetta di ciascun campo. Conserva la mappatura: gli ID sono stabili.
- 3
Gestisci la paginazione
Una singola richiesta restituisce al massimo 100 risposte. Recupera le pagine successive usando totalPages.
- 4
Aggiungi una cache
Non chiamare l’API a ogni caricamento di pagina. Una cache di alcuni minuti è più che sufficiente e riduce anche il carico di lavoro per te.
- 5
Filtra ciò che pubblichi
Scegli campi specifici. Non inviare mai l’intero oggetto della risposta al browser.
Dati personali: un elenco di nomi su un sito pubblico è una pubblicazione di dati personali. Assicurati di avere una base giuridica, oppure pubblica solo dettagli che gli interessati si aspettano siano pubblici (ad esempio i nomi in un elenco di partecipanti di cui erano già stati informati).
FAQ
Posso chiamare l’API direttamente dal browser?
Non con la tua chiave API: sarebbe pubblica. Passa sempre dal tuo server.
Perché le chiavi dei dati hanno la forma field_1778…?
Sono gli ID dei campi del form. Recupera le loro etichette dal dettaglio del form.
Con quale frequenza devo fare richieste?
Dipende dalle necessità: per un elenco di iscritti basta ogni pochi minuti. Per reazioni immediate usa un webhook.
L’API gestisce i caratteri diacritici?
Sì, tutto è in UTF-8.
Correlati
Prova Gatherino gratis
Piano gratuito: 3 moduli e 100 risposte al mese. Nessuna carta di credito, dati ospitati nell'UE.
Inizia gratis →