REST API

Når du vil vise svar på din egen hjemmeside eller hente dem ind i dit system efter en fast tidsplan, bruger du REST API'et. Det returnerer JSON, godkender med en API-nøgle og understøtter de samme filtre, som du kender fra resultattabellen.

Kom i gang gratis →Priser

Godt at vide: Gatherino-editoren og kontoen findes på engelsk eller tjekkisk. Formularerne, som respondenterne udfylder, kan vises på 18 sprog, herunder dansk.

Hvad API'et kan

  • Hent en liste over formularerne i et workspace og en enkelt formular inklusive dens struktur.
  • Hent en liste over svar med filtre: efter formular, status, datointerval, fritekst samt sortering.
  • Hent et enkelt svar.
  • Opdater status på et svar.
  • Send svar til en formular programmatisk — nyttigt til migreringer eller et tilpasset frontend.

Hentning af svar

Godkendelse sker med Authorization-headeren (en x-api-key-header virker også):

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 }

Kom i gang

  1. 1

    Opret en API-nøgle

    Under Indstillinger → API-nøgler. Nøglen vises kun én gang, så gem den med det samme.

  2. 2

    Lav dit første kald

    Prøv at hente en liste over formularer for at bekræfte, at nøglen virker, og for at finde formular-ID'et.

  3. 3

    Kobl felt-ID'er til etiketter

    Formularens detaljer returnerer hvert felts ID og etiket — byg et opslag ud fra det. Felt-ID'er er stabile, så det er nok at hente dem én gang.

  4. 4

    Håndter paginering

    Maksimum er 100 svar pr. anmodning. For at få flere data går du gennem siderne, indtil du når den sidste.

API-nøglen skal ligge på din server, aldrig i browserens JavaScript — alle kan læse den der og downloade alle dine svar. Hvis du offentliggør svar, så eksponér kun felter, der er beregnet til offentliggørelse, aldrig personoplysninger.

FAQ

Hvordan godkender API'et?

Med en API-nøgle: enten en Authorization: Bearer <key>-header eller en x-api-key-header. En ugyldig nøgle returnerer 401.

Hvor mange svar pr. anmodning?

Op til 100. Svaret indeholder total og totalPages, så du kan bladre videre til flere sider.

Hvorfor hedder datanøglerne field_1778…?

Det er formularens felt-ID'er. Hent deres etiketter fra formularens detaljer, og behold koblingen på din side.

Understøtter API'et diakritiske tegn?

Ja, alt er UTF-8, så tjekkisk og andre sprog fungerer uden problemer.

Relateret

API-dokumentationWebhooksHåndtering af svarDiscordGoogle Sheets

Prøv Gatherino gratis

Gratis plan: 3 formularer og 100 svar om måneden. Intet kreditkort, data hostet i EU.

Kom i gang gratis →