Kako sigurno objaviti odgovore obrasca na vašoj web-stranici

Čest zahtjev: „Želim na stranici prikazati popis prijavljenih“ ili „Trebam odgovore u vlastitom administratorskom sučelju“. REST API to omogućuje, a razlika između sigurne i nesigurne implementacije svodi se na jednu stvar: gdje se nalazi API ključ.

Počnite besplatno →Cijene

Dobro je znati: uređivač i račun u Gatherinu dostupni su na engleskom ili češkom. Obrasci koje ispunjavaju vaši korisnici mogu se prikazati na 18 jezika, uključujući hrvatski.

Osnovno pravilo

API ključ pripada vašem poslužitelju, nikada JavaScriptu u pregledniku. Ako ključ stavite u frontend kod, svatko ga može pročitati iz izvornog koda stranice i preuzeti svaki odgovor sa svih vaših obrazaca, a ne samo one koje ste htjeli prikazati.

Ispravan tijek je: preglednik traži od vašeg poslužitelja → vaš poslužitelj traži od Gatherina uz ključ → vaš poslužitelj vraća samo polja koja su namijenjena javnosti.

Poslužiteljski dio

Dohvaćanje odgovora na poslužiteljskoj strani (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],
}));

Koraci

  1. 1

    Izradite API ključ

    U Postavke → API ključevi. Prikazuje se samo jednom, zato ga pohranite u varijablu okruženja na poslužitelju.

  2. 2

    Pronađite ID-jeve polja

    Krajnja točka za detalje obrasca vraća ID i naziv svakog polja. Zadržite mapiranje jer su ID-jevi stabilni.

  3. 3

    Rukovanje paginacijom

    Jedan zahtjev vraća najviše 100 odgovora. Dohvatite dodatne stranice pomoću polja totalPages.

  4. 4

    Dodajte predmemoriranje

    Ne pozivajte API pri svakom učitavanju stranice. Dovoljno je podatke predmemorirati na nekoliko minuta, a to štedi i vaš trud.

  5. 5

    Filtrirajte što objavljujete

    Odaberite određena polja. Nikada ne šaljite cijeli objekt odgovora u preglednik.

Osobni podaci: popis imena na javnoj web-stranici znači objavu osobnih podataka. Provjerite imate li pravni temelj ili objavite samo podatke koje ispitanici očekuju da budu javni (primjerice imena na popisu polaznika o kojem su unaprijed bili obaviješteni).

Česta pitanja

Mogu li API pozivati izravno iz preglednika?

Ne s vašim API ključem jer bi on bio javan. Uvijek idite preko vlastitog poslužitelja.

Zašto su ključevi podataka poput field_1778…?

To su ID-jevi polja obrasca. Njihove nazive dohvatite iz detalja obrasca.

Koliko često trebam dohvaćati podatke?

Prema potrebi. Za popis prijavljenih dovoljno je svakih nekoliko minuta. Za trenutne reakcije koristite webhook.

Podržava li API dijakritičke znakove?

Da, sve je u UTF-8 kodiranju.

Povezano

REST APIDokumentacija API-jaWebhookoviPotvrdne e-poruke koje zaista štede posaoGDPR i internetski obrasciKako poboljšati stopu popunjavanja obrasca

Isprobajte Gatherino besplatno

Besplatni paket: 3 obrasca i 100 odgovora mjesečno. Bez kreditne kartice, podaci pohranjeni u EU.

Počnite besplatno →