Lomakevastausten turvallinen julkaiseminen verkkosivullasi
Yleinen pyyntö: ”Haluan näyttää rekisteröityjen listan sivustollamme” tai ”Tarvitsen vastaukset omaan ylläpitonäkymääni”. REST API:n avulla tämä onnistuu, ja turvallisen ja turvattoman toteutuksen ero riippuu yhdestä asiasta: siitä, missä API-avain sijaitsee.
Hyvä tietää: Gatherino-editori ja käyttäjätili ovat englanniksi tai tšekiksi. Vastaajille näytettävät lomakkeet voi näyttää 18 kielellä, myös suomeksi.
Perussääntö
API-avain kuuluu palvelimelle, ei koskaan selaimen JavaScript-koodiin. Jos avain on sivun koodissa, kuka tahansa voi lukea sen sivun lähdekoodista ja ladata jokaisen vastauksen kaikista lomakkeistasi, ei vain niistä, jotka aiot näyttää.
Oikea kulku on seuraava: selain pyytää tietoja omalta palvelimeltasi → palvelin pyytää vastaukset Gatherinolta avaimella → palvelin palauttaa selaimelle vain ne kentät, jotka on tarkoitettu julkisiksi.
Palvelinpuoli
Vastausten hakeminen taustapalvelimelta (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],
}));Vaiheet
- 1
Luo API-avain
Asetukset → API-avaimet. Avain näytetään vain kerran, joten tallenna se palvelimen ympäristömuuttujaan.
- 2
Etsi kenttä-ID:t
Lomakkeen tiedot -päätepiste palauttaa kunkin kentän ID:n ja nimiön. Säilytä kartoitus, sillä ID:t pysyvät vakaina.
- 3
Käsittele sivutus
Yksi pyyntö palauttaa enintään 100 vastausta. Hae lisäsivut käyttämällä totalPages-kenttää.
- 4
Lisää välimuisti
Älä kutsu API:a jokaisella sivulatauksella. Muutaman minuutin välimuisti riittää ja helpottaa myös omaa työtäsi.
- 5
Suodata julkaistava sisältö
Valitse vain tietyt kentät. Älä koskaan lähetä koko vastausobjektia selaimelle.
Henkilötiedot: julkisella verkkosivulla julkaistava nimilista on henkilötietojen julkaisemista. Varmista, että sinulla on oikeusperuste, tai julkaise vain tiedot, jotka vastaajat odottavat julkisiksi (esimerkiksi nimet lähtölistalla, josta he tiesivät etukäteen).
UKK
Voinko kutsua API:a suoraan selaimesta?
Et API-avaimella, sillä se olisi julkinen. Kulje aina oman palvelimesi kautta.
Miksi tietojen avaimet ovat muotoa field_1778…?
Ne ovat lomakkeen kenttä-ID:itä. Hae niiden nimiöt lomakkeen tiedoista.
Kuinka usein vastauksia kannattaa hakea?
Tarpeen mukaan. Rekisteröityjen listaan riittää muutaman minuutin väli. Välittömiin reaktioihin käytä webhookia.
Tukeeko API ääkkösiä?
Kyllä, kaikki data on UTF-8-koodauksessa.
Aiheeseen liittyvää
Kokeile Gatherinoa ilmaiseksi
Ilmainen paketti: 3 lomaketta ja 100 vastausta kuukaudessa. Ei luottokorttia, tiedot isännöidään EU:ssa.
Aloita ilmaiseksi →