Hogyan tegye közzé biztonságosan az űrlapválaszokat a weboldalán?

Gyakori kérés: „Szeretnénk a weboldalunkon megjeleníteni a jelentkezők listáját” vagy „a saját adminisztrációmban kell látnom a válaszokat”. A REST API ezt megoldja. A biztonságos és a nem biztonságos megvalósítás közötti különbség egyetlen dolgon múlik: azon, hol van az API-kulcs.

Kezdje el ingyen →Árak

Jó tudni: a Gatherino szerkesztője és fiókja angol vagy cseh nyelven érhető el. A kitöltők által látott űrlapok 18 nyelven jeleníthetők meg, ideértve a magyart is.

Az alapszabály

Az API-kulcsnak az Ön szerverén van a helye, soha nem a böngészőoldali JavaScriptben. Ha a kulcs a front-end kódban van, bárki kiolvashatja az oldal forrásából, és letölthet minden választ az összes űrlapjáról, nem csak azokat, amelyeket meg szeretne jeleníteni.

A helyes folyamat: a böngésző kérést küld az Ön szerverének, a szerver a kulccsal kérést intéz a Gatherinohoz, majd a szerver csak azokat a mezőket adja vissza, amelyeknek nyilvánosnak kell lenniük.

A szerveroldali rész

Válaszok lekérése a háttérrendszerben (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],
}));

A lépések

  1. 1

    API-kulcs létrehozása

    A Beállítások → API-kulcsok menüpontban. Csak egyszer jelenik meg, ezért szerveroldali környezeti változóban tárolja.

  2. 2

    A mezőazonosítók megkeresése

    Az űrlap részletei végpont visszaadja az egyes mezők azonosítóját és címkéjét. Őrizze meg a megfeleltetést, mert az azonosítók stabilak.

  3. 3

    Lapozás kezelése

    Egy kérés legfeljebb 100 választ ad vissza. További oldalakat a totalPages mező alapján kérdezzen le.

  4. 4

    Gyorsítótárazás

    Ne hívja meg az API-t minden oldalbetöltéskor. Néhány perces gyorsítótárazás bőven elég, és Önnek is kevesebb munkát jelent.

  5. 5

    Szűrje, mit tesz közzé

    Válasszon ki konkrét mezőket. Soha ne küldje el a teljes válaszobjektumot a böngészőnek.

Személyes adatok: a nevek listája egy nyilvános weboldalon személyes adatok közzétételét jelenti. Győződjön meg róla, hogy van jogalapja, vagy csak olyan adatokat tegyen közzé, amelyek nyilvánosságát a válaszadók várják (például olyan indulólista neveit, amelyekről előre tudtak).

GYIK

Hívhatom az API-t közvetlenül a böngészőből?

Az API-kulccsal nem, mert az nyilvánossá válna. Mindig a saját szerveren keresztül dolgozzon.

Miért olyanok az adatkulcsok, mint a field_1778…?

Ezek az űrlap mezőazonosítói. Címkéiket az űrlap részleteiből kérdezze le.

Milyen gyakran kérdezzek le adatot?

Igény szerint. Egy jelentkezőlistához néhány percenként bőven elég. Azonnali reakcióhoz használjon webhookot.

Kezeli az API az ékezetes karaktereket?

Igen, minden UTF-8 kódolású.

Kapcsolódó

REST APIAPI-dokumentációWebhookokVisszaigazoló e-mailek, amelyek valóban időt spórolnakGDPR és online űrlapokHogyan javítsa az űrlap-kitöltési arányt

Próbálja ki a Gatherinót ingyen

Ingyenes csomag: havi 3 űrlap és 100 válasz. Bankkártya nem szükséges, az adatok EU-ban tárolódnak.

Kezdje el ingyen →