REST API

När du vill visa svar på din egen webbplats eller hämta in dem i ditt system enligt schema använder du REST API:et. Det returnerar JSON, autentiserar med en API-nyckel och stöder samma filter som du känner igen från resultattabellen.

Kom igång gratis →Priser

Bra att veta: Gatherino-redigeraren och kontot finns på engelska eller tjeckiska. Formulären som dina respondenter fyller i kan visas på 18 språk, inklusive svenska.

Det här kan API:et göra

  • Lista formulären i en arbetsyta och hämta ett enskilt formulär med dess struktur.
  • Lista svar med filter: efter formulär, status, datumintervall och fritextsökning, samt sortering.
  • Hämta ett enskilt svar.
  • Uppdatera status för ett svar.
  • Skicka in ett formulär programmatiskt – användbart vid migreringar eller för ett eget användargränssnitt.

Hämta svar

Autentisering sker med Authorization-headern (en x-api-key-header fungerar också):

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 }

Så kommer du igång

  1. 1

    Skapa en API-nyckel

    Gå till Inställningar → API-nycklar. Nyckeln visas bara en gång, så spara den direkt.

  2. 2

    Gör ditt första anrop

    Prova att lista formulär för att bekräfta att nyckeln fungerar och för att hämta formulärets ID.

  3. 3

    Koppla fält-ID:n till etiketter

    Formulärdetaljerna returnerar varje fälts ID och etikett – bygg en uppslagstabell utifrån det. Fält-ID:n är stabila, så det räcker att hämta dem en gång.

  4. 4

    Hantera paginering

    Maxgränsen är 100 svar per förfrågan. För mer data bläddrar du igenom sidorna tills du når den sista.

API-nyckeln ska ligga på din server, aldrig i JavaScript i webbläsaren – vem som helst kan läsa den där och ladda ner alla dina svar. Om du publicerar svar ska du bara exponera fält som är avsedda för publicering, aldrig personuppgifter.

Vanliga frågor

Hur autentiserar API:et?

Med en API-nyckel: antingen en Authorization: Bearer <key>-header eller en x-api-key-header. En ogiltig nyckel returnerar 401.

Hur många svar per förfrågan?

Upp till 100. Svaret innehåller total och totalPages så att du kan gå vidare till fler sidor.

Varför ser datanycklarna ut som field_1778…?

Det är formulärets fält-ID:n. Hämta deras etiketter från formulärdetaljerna och behåll kopplingen på din sida.

Hanterar API:et specialtecken?

Ja, allt är UTF-8, så tjeckiska tecken och andra språk fungerar utan problem.

Relaterat

API-dokumentationWebhooksHantering av svarDiscordGoogle Sheets

Prova Gatherino gratis

Gratisplan: 3 formulär och 100 svar per månad. Inget kreditkort krävs och data lagras inom EU.

Kom igång gratis →