REST API

Wenn Sie Antworten auf Ihrer eigenen Website anzeigen oder regelmäßig in Ihr System übernehmen möchten, nutzen Sie die REST API. Sie liefert JSON, authentifiziert sich mit einem API-Schlüssel und unterstützt dieselben Filter, die Sie aus der Ergebnistabelle kennen.

Kostenlos starten →Preise

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.

Was die API kann

  • Formulare in einem Arbeitsbereich auflisten und ein einzelnes Formular einschließlich seiner Struktur abrufen.
  • Antworten mit Filtern auflisten: nach Formular, Status, Datumsbereich und Volltext sowie mit Sortierung.
  • Eine einzelne Antwort abrufen.
  • Den Status einer Antwort aktualisieren.
  • Ein Formular programmatisch absenden – nützlich für Migrationen oder ein individuelles Frontend.

Antworten abrufen

Authentifizierung über den Authorization-Header (ein x-api-key-Header funktioniert ebenfalls):

curl "https://gatherino.com/api/v1/submissions?formId=FORM_ID&limit=50" \
  -H "Authorization: Bearer gk_your_key"

# response
{ "items": [ { "id": "…", "status": "NEW", "createdAt": "…",
               "data": { "field_1778…": "Jan Vondráček" } } ],
  "total": 672, "page": 1, "limit": 50, "totalPages": 14 }

Erste Schritte

  1. 1

    API-Schlüssel erstellen

    Unter Einstellungen → API-Schlüssel. Der Schlüssel wird nur einmal angezeigt, speichern Sie ihn daher sofort.

  2. 2

    Ersten Aufruf senden

    Listen Sie Formulare auf, um zu prüfen, ob der Schlüssel funktioniert, und ermitteln Sie die Formular-ID.

  3. 3

    Feld-IDs den Bezeichnungen zuordnen

    Die Formulardetails enthalten die ID und Bezeichnung jedes Feldes. Erstellen Sie daraus eine Zuordnung. Feld-IDs bleiben stabil, ein einmaliges Abrufen genügt.

  4. 4

    Seitenweise abrufen

    Das Maximum liegt bei 100 Antworten pro Anfrage. Für mehr Daten durchlaufen Sie die Seiten, bis Sie die letzte erreicht haben.

Der API-Schlüssel gehört auf Ihren Server, niemals in das JavaScript des Browsers. Dort könnte ihn jeder auslesen und alle Ihre Antworten herunterladen. Wenn Sie Antworten veröffentlichen, geben Sie nur Felder frei, die zur Veröffentlichung vorgesehen sind – niemals personenbezogene Daten.

FAQ

Wie authentifiziert sich die API?

Mit einem API-Schlüssel: entweder über einen Authorization: Bearer <key>-Header oder einen x-api-key-Header. Ein ungültiger Schlüssel liefert 401 zurück.

Wie viele Antworten pro Anfrage?

Bis zu 100. Die Antwort enthält total und totalPages, sodass Sie weitere Seiten abrufen können.

Warum lauten die Datenschlüssel wie field_1778…?

Das sind die Feld-IDs des Formulars. Rufen Sie deren Bezeichnungen aus den Formulardetails ab und pflegen Sie die Zuordnung in Ihrem System.

Unterstützt die API Diakritika?

Ja, alles ist UTF-8-kodiert, daher funktionieren Tschechisch und andere Sprachen problemlos.

Verwandte Inhalte

API-DokumentationWebhooksAntwortverwaltungDiscordGoogle Sheets

Gatherino kostenlos testen

Kostenloser Tarif: 3 Formulare und 100 Antworten pro Monat. Keine Kreditkarte nötig, Daten werden in der EU gehostet.

Kostenlos starten →