API REST

Quando devi mostrare le risposte sul tuo sito o trasferirle nel tuo sistema a intervalli regolari, usa l'API REST. Restituisce i dati in formato JSON, si autentica con una chiave API e supporta gli stessi filtri che conosci dalla tabella dei risultati.

Inizia gratis →Prezzi

Da sapere: l'editor e l'account di Gatherino sono disponibili in inglese o ceco. I moduli compilati dai tuoi rispondenti possono essere mostrati in 18 lingue, inclusa questa.

Cosa può fare l'API

  • Elenca i moduli di uno spazio di lavoro e recupera un singolo modulo con la sua struttura.
  • Elenca le risposte con filtri per modulo, stato, intervallo di date e ricerca testuale, con ordinamento.
  • Recupera una singola risposta.
  • Aggiorna lo stato di una risposta.
  • Invia una risposta a un modulo via codice: utile per migrazioni o per un front end personalizzato.

Recupero delle risposte

Autenticazione tramite l'header Authorization (funziona anche l'header 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 }

Come iniziare

  1. 1

    Crea una chiave API

    In Impostazioni → Chiavi API. La chiave viene mostrata una sola volta, quindi salvala subito.

  2. 2

    Fai la tua prima chiamata

    Prova a elencare i moduli per verificare che la chiave funzioni e recuperare l'ID del modulo.

  3. 3

    Collega gli ID dei campi alle etichette

    I dettagli del modulo restituiscono l'ID e l'etichetta di ogni campo: crea una tabella di corrispondenza a partire da lì. Gli ID dei campi sono stabili, quindi basta recuperarli una volta.

  4. 4

    Gestione della paginazione

    Il massimo è 100 risposte per richiesta. Per recuperare altri dati, scorri le pagine fino all'ultima.

La chiave API va conservata sul tuo server, mai nel JavaScript del browser: chiunque potrebbe leggerla e scaricare tutte le tue risposte. Se pubblichi le risposte, esponi solo i campi destinati alla pubblicazione, mai dati personali.

FAQ

Come si autentica l'API?

Con una chiave API: tramite l'header Authorization: Bearer <key> oppure l'header x-api-key. Una chiave non valida restituisce 401.

Quante risposte per richiesta?

Fino a 100. La risposta include total e totalPages, così puoi scorrere le pagine successive.

Perché le chiavi dei dati hanno la forma field_1778…?

Sono gli ID dei campi del modulo. Recupera le loro etichette dai dettagli del modulo e conserva la corrispondenza nel tuo sistema.

L'API gestisce i caratteri diacritici?

Sì, tutto è in UTF-8, quindi il ceco e le altre lingue funzionano senza problemi.

Correlati

Documentazione APIWebhookGestione delle risposteDiscordGoogle Sheets

Prova Gatherino gratis

Piano gratuito: 3 moduli e 100 risposte al mese. Nessuna carta di credito, dati ospitati nell'UE.

Inizia gratis →