REST API

Kada želite prikazati odgovore na vlastitoj web stranici ili ih prema rasporedu prenositi u svoj sustav, koristite REST API. Vraća JSON, autentificira se API ključem i podržava iste filtere koje poznajete iz tablice s rezultatima.

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.

Mogućnosti API-ja

  • Popis obrazaca u radnom prostoru i dohvat pojedinog obrasca s njegovom strukturom.
  • Popis odgovora s filterima: prema obrascu, statusu, rasponu datuma i punom tekstu, uz sortiranje.
  • Dohvat pojedinog odgovora.
  • Ažuriranje statusa odgovora.
  • Programsko slanje obrasca – korisno za migracije ili vlastito korisničko sučelje.

Dohvat odgovora

Autentifikacija se provodi zaglavljem Authorization (radi i zaglavlje x-api-key):

curl "https://gatherino.com/api/v1/submissions?formId=FORM_ID&limit=50" \
  -H "Authorization: Bearer gk_your_key"

# response
{ "items": [ { "id": "…", "status": "NEW", "createdAt": "…",
               "data": { "field_1778…": "Jan Vondráček" } } ],
  "total": 672, "page": 1, "limit": 50, "totalPages": 14 }

Prvi koraci

  1. 1

    Izradite API ključ

    U Postavkama → API ključevi. Ključ se prikazuje samo jednom, zato ga odmah spremite.

  2. 2

    Uputite prvi poziv

    Pokušajte popisati obrasce kako biste potvrdili da ključ radi i dohvatili ID obrasca.

  3. 3

    Povežite ID-jeve polja s oznakama

    Pojedinosti obrasca vraćaju ID i oznaku svakog polja – na temelju toga izradite preslikavanje. ID-jevi polja su stabilni, pa je dovoljno dohvatiti ih jednom.

  4. 4

    Paginacija

    Najviše je 100 odgovora po zahtjevu. Za više podataka prolazite kroz stranice dok ne dođete do posljednje.

API ključ mora biti na vašem poslužitelju, nikada u JavaScriptu u pregledniku – svatko bi ga tamo mogao pročitati i preuzeti sve vaše odgovore. Ako objavljujete odgovore, izložite samo polja namijenjena objavi, nikada osobne podatke.

Česta pitanja

Kako se API autentificira?

API ključem: zaglavljem Authorization: Bearer <ključ> ili zaglavljem x-api-key. Neispravan ključ vraća 401.

Koliko odgovora po zahtjevu?

Najviše 100. Odgovor sadrži polja total i totalPages kako biste mogli prolaziti kroz dodatne stranice.

Zašto podaci imaju ključeve poput field_1778…?

To su ID-jevi polja obrasca. Dohvatite njihove oznake iz detalja obrasca i zadržite preslikavanje na svojoj strani.

Podržava li API dijakritičke znakove?

Da, sve je u UTF-8, pa češki i ostali jezici rade bez problema.

Povezano

API dokumentacijaWebhookoviUpravljanje odgovorimaDiscordGoogle Sheets

Isprobajte Gatherino besplatno

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

Počnite besplatno →