Så publicerar du formulärsvar säkert på din webbplats

Ett vanligt önskemål: ”Jag vill visa en lista över deltagare på vår webbplats” eller ”Jag behöver se svaren i min egen adminpanel”. REST API klarar det, och skillnaden mellan en säker och en osäker lösning beror på en sak: var API-nyckeln finns.

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.

Grundregeln

API-nyckeln hör hemma på din server, aldrig i JavaScript i webbläsaren. Lägger du nyckeln i frontend-koden kan vem som helst läsa den i sidans källkod och ladda ner alla svar från alla dina formulär, inte bara de du tänkt visa.

Så här ska flödet se ut: webbläsaren frågar din server → din server frågar Gatherino med nyckeln → din server returnerar bara de fält som är avsedda att vara offentliga.

Serverdelen

Hämta svar i din 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],
}));

Stegen

  1. 1

    Skapa en API-nyckel

    Under Inställningar → API-nycklar. Den visas bara en gång, så spara den i en miljövariabel på servern.

  2. 2

    Hitta fält-ID:n

    Endpointen för formulärdetaljer returnerar varje fälts ID och etikett. Spara mappningen, eftersom ID:n är stabila.

  3. 3

    Hantera sidindelning

    Ett anrop returnerar högst 100 svar. Gå igenom fler sidor med hjälp av totalPages.

  4. 4

    Lägg till cachning

    Anropa inte API:et vid varje sidvisning. Cachning i några minuter räcker gott och sparar dessutom dig besvär.

  5. 5

    Filtrera det du publicerar

    Välj specifika fält. Skicka aldrig hela svarsobjektet till webbläsaren.

Personuppgifter: en namnlista på en offentlig webbplats är en publicering av personuppgifter. Se till att du har en rättslig grund, eller publicera endast uppgifter som deltagarna förväntar sig ska vara offentliga (till exempel namn på en startlista de kände till i förväg).

Vanliga frågor

Kan jag anropa API:et direkt från webbläsaren?

Inte med din API-nyckel, eftersom den då skulle bli offentlig. Gå alltid via din egen server.

Varför ser datanycklarna ut som field_1778…?

Det är formulärets fält-ID:n. Hämta deras etiketter från formulärets detaljer.

Hur ofta bör jag hämta data?

Efter behov. För en deltagarlista räcker det gott med hämtning med några minuters mellanrum. För omedelbara reaktioner använder du en webhook.

Hanterar API:et diakritiska tecken?

Ja, allt är UTF-8.

Relaterat

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 →