Kako varno objaviti odgovore obrazca na vaši spletni strani

Pogosta zahteva: „Na naši strani želim prikazati seznam prijavljenih“ ali „Odgovore potrebujem neposredno v svoji administraciji“. REST API to omogoča, razlika med varno in nevarno izvedbo pa je v eni stvari: kje se nahaja API ključ.

Začnite brezplačno →Cene

Dobro je vedeti: urejevalnik in račun Gatherino sta v angleščini ali češčini. Obrazci, ki jih izpolnjujejo vaši izpolnjevalci, so lahko prikazani v 18 jezikih, vključno s slovenščino.

Osnovno pravilo

API ključ mora biti na vašem strežniku, nikoli v JavaScriptu v brskalniku. Če ključ vstavite v kodo na strani, ga lahko kdorkoli prebere iz izvorne kode strani in prenese vse odgovore z vseh vaših obrazcev, ne le tistih, ki ste jih želeli prikazati.

Pravilen potek je naslednji: brskalnik zahteva podatke od vašega strežnika → vaš strežnik z ključem zahteva podatke pri Gatherinu → vaš strežnik vrne samo polja, ki so namenjena javnosti.

Strežniški del

Pridobivanje odgovorov na vašem zaledju (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],
}));

Koraki

  1. 1

    Ustvarite API ključ

    Najdete ga pod Nastavitve → API ključi. Prikaže se samo enkrat, zato ga shranite v okoljsko spremenljivko na strežniku.

  2. 2

    Poiščite ID-je polj

    Končna točka s podrobnostmi obrazca vrne ID in oznako vsakega polja. Preslikavo shranite, ker so ID-ji stabilni.

  3. 3

    Obdelajte paginacijo

    Ena zahteva vrne največ 100 odgovorov. Ostale strani pregledujte prek polja totalPages.

  4. 4

    Dodajte predpomnjenje

    API ne kličite ob vsakem nalaganju strani. Predpomnjenje za nekaj minut zadostuje in vam tudi prihrani trud.

  5. 5

    Filtrirajte, kaj objavljate

    Izberite samo določena polja. Celotnega objekta odgovora nikoli ne pošiljajte v brskalnik.

Osebni podatki: seznam imen na javni spletni strani pomeni objavo osebnih podatkov. Poskrbite za pravno podlago ali objavite samo podatke, ki jih udeleženci pričakujejo kot javne (na primer imena na seznamu udeležencev, o katerem so bili vnaprej obveščeni).

Pogosta vprašanja

Ali lahko API kličem neposredno iz brskalnika?

Ne z vašim API ključem, saj bi bil javno viden. Podatke vedno zahtevajte prek lastnega strežnika.

Zakaj imajo podatki ključe, kot je field_1778…?

To so ID-ji polj obrazca. Njihove oznake pridobite iz podrobnosti obrazca.

Kako pogosto naj pridobivam podatke?

Glede na potrebe. Za seznam udeležencev zadostuje vsakih nekaj minut. Za takojšnje odzive uporabite webhook.

Ali API podpira šumnike?

Da, vse je v kodiranju UTF-8.

Sorodno

REST APIDokumentacija API-jaWebhookiPotrditvena e-poštna sporočila, ki vam dejansko prihranijo deloGDPR in spletni obrazciKako izboljšati stopnjo izpolnjevanja obrazcev

Preizkusite Gatherino brezplačno

Brezplačni paket: 3 obrazci in 100 odgovorov na mesec. Brez kreditne kartice, podatki so gostovani v EU.

Začnite brezplačno →