Comment publier en toute sécurité les réponses d'un formulaire sur votre site
Une demande fréquente : « Je veux afficher la liste des inscrits sur notre site » ou « J'ai besoin des réponses dans mon propre back-office ». L'API REST permet de le faire, et la différence entre une mise en œuvre sûre et une mise en œuvre risquée tient à un seul point : l'endroit où se trouve la clé API.
Bon à savoir : l'éditeur et le compte Gatherino sont disponibles en anglais ou en tchèque. Les formulaires que vos répondants remplissent peuvent s'afficher dans 18 langues, dont le français.
La règle de base
La clé API doit rester sur votre serveur, jamais dans le JavaScript du navigateur. Si vous l'intégrez au code côté client, n'importe qui peut la lire dans le code source de la page et télécharger chaque réponse de chacun de vos formulaires, et pas seulement celles que vous souhaitiez afficher.
Le flux correct est le suivant : le navigateur demande des données à votre serveur, votre serveur interroge Gatherino avec la clé, puis renvoie uniquement les champs destinés à être publics.
La partie serveur
Récupération des réponses sur votre 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],
}));Les étapes
- 1
Créer une clé API
Rendez-vous dans Paramètres → Clés API. La clé n'est affichée qu'une seule fois : stockez-la dans une variable d'environnement côté serveur.
- 2
Trouver les ID des champs
L'endpoint de détail du formulaire renvoie l'ID et le libellé de chaque champ. Conservez cette correspondance, car les ID sont stables.
- 3
Gérer la pagination
Une requête renvoie au maximum 100 réponses. Parcourez les pages suivantes à l'aide de totalPages.
- 4
Ajouter une mise en cache
N'appelez pas l'API à chaque chargement de page. Une mise en cache de quelques minutes suffit amplement et vous fait aussi gagner du temps.
- 5
Filtrer ce que vous publiez
Sélectionnez des champs précis. N'envoyez jamais l'objet de réponse complet au navigateur.
Données personnelles : une liste de noms sur un site web public constitue une publication de données personnelles. Assurez-vous de disposer d'une base juridique, ou ne publiez que les informations que les personnes concernées peuvent raisonnablement s'attendre à voir publiées (par exemple les noms figurant sur une liste de départ dont elles avaient été informées à l'avance).
FAQ
Puis-je appeler l'API directement depuis le navigateur ?
Pas avec votre clé API : elle serait alors publique. Passez toujours par votre propre serveur.
Pourquoi les clés de données ont-elles la forme field_1778… ?
Ce sont les ID de champs du formulaire. Récupérez leurs libellés depuis le détail du formulaire.
À quelle fréquence dois-je interroger l'API ?
Selon vos besoins : pour une liste d'inscrits, une interrogation toutes les quelques minutes suffit. Pour réagir instantanément, utilisez un webhook.
L'API gère-t-elle les caractères accentués ?
Oui, tout est encodé en UTF-8.
Pages connexes
Essayez Gatherino gratuitement
Offre gratuite : 3 formulaires et 100 réponses par mois. Sans carte bancaire, données hébergées dans l'UE.
Commencer gratuitement →