So veröffentlichen Sie Formularantworten sicher auf Ihrer Website
Ein häufiger Wunsch: „Wir möchten eine Liste der Anmeldungen auf unserer Website zeigen“ oder „Ich brauche die Antworten direkt in meiner eigenen Verwaltung“. Die REST API leistet genau das. Der Unterschied zwischen einer sicheren und einer unsicheren Umsetzung liegt in einem einzigen Punkt: dem Ort des API-Schlüssels.
Gut zu wissen: Der Gatherino-Editor und das Konto sind auf Englisch oder Tschechisch verfügbar. Die Formulare, die Ihre Teilnehmenden ausfüllen, können in 18 Sprachen angezeigt werden, einschließlich Deutsch.
Die Grundregel
Der API-Schlüssel gehört auf Ihren Server, niemals in den JavaScript-Code des Browsers. Steht der Schlüssel im Front-End-Code, kann ihn jeder im Quelltext der Seite auslesen und alle Antworten aus allen Ihren Formularen herunterladen, nicht nur die, die Sie anzeigen wollten.
Der richtige Ablauf: Der Browser fragt Ihren Server an → Ihr Server fragt Gatherino mit dem Schlüssel an → Ihr Server gibt nur die Felder zurück, die öffentlich sein sollen.
Der Server-Teil
Antworten in Ihrem Backend abrufen (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],
}));Die Schritte
- 1
API-Schlüssel erstellen
Unter Einstellungen → API-Schlüssel. Er wird nur einmal angezeigt. Speichern Sie ihn daher in einer serverseitigen Umgebungsvariable.
- 2
Feld-IDs ermitteln
Der Endpunkt für die Formulardetails liefert die ID und Bezeichnung jedes Feldes. Bewahren Sie die Zuordnung auf, denn IDs bleiben stabil.
- 3
Paginierung umsetzen
Eine Anfrage liefert höchstens 100 Antworten. Weitere Seiten fragen Sie anhand von totalPages ab.
- 4
Caching einrichten
Rufen Sie die API nicht bei jedem Seitenaufruf auf. Ein Caching von einigen Minuten reicht völlig und spart Ihnen zusätzlich Aufwand.
- 5
Veröffentlichte Daten filtern
Wählen Sie gezielt einzelne Felder aus. Übertragen Sie niemals das gesamte Antwortobjekt an den Browser.
Personenbezogene Daten: Eine Namensliste auf einer öffentlichen Website ist eine Veröffentlichung personenbezogener Daten. Stellen Sie sicher, dass Sie über eine Rechtsgrundlage verfügen, oder veröffentlichen Sie nur Angaben, mit denen die Teilnehmenden rechnen (zum Beispiel Namen auf einer Teilnehmerliste, die ihnen im Voraus bekannt war).
FAQ
Kann ich die API direkt aus dem Browser aufrufen?
Nicht mit Ihrem API-Schlüssel, denn er wäre öffentlich. Gehen Sie immer über Ihren eigenen Server.
Warum lauten die Datenschlüssel wie field_1778…?
Das sind die Feld-IDs des Formulars. Deren Bezeichnungen holen Sie aus den Formulardetails.
Wie oft sollte ich Daten abrufen?
Je nach Bedarf. Für eine Teilnehmerliste reicht alle paar Minuten völlig. Für sofortige Reaktionen nutzen Sie einen Webhook.
Unterstützt die API Akzente und Umlaute?
Ja, alle Daten sind in UTF-8 kodiert.
Verwandte Inhalte
Gatherino kostenlos testen
Kostenloser Tarif: 3 Formulare und 100 Antworten pro Monat. Keine Kreditkarte nötig, Daten werden in der EU gehostet.
Kostenlos starten →