Una semplice API REST

Per iniziare

Tutte le richieste vanno all'URL di base e includono la Sua chiave come token Bearer; la risposta è sempre application/json. Per ogni chiave stabilisce per risorsa (moduli, invii) se può leggere o anche scrivere — i permessi di scrittura non vengono mai concessi automaticamente.

URL di base

https://app.formuliermet.nl/api/v1

Autenticazione

curl https://app.formuliermet.nl/api/v1/me \
  -H "Authorization: Bearer fmb_je_sleutel_hier"

Crei una chiave nell'app in Account → API e integrazioni. Vedrà la chiave completa una sola volta — la conservi in un luogo sicuro. Una chiave dà accesso ai dati del Suo account; può revocarla in qualsiasi momento. L'accesso API è incluso nei pacchetti superiori (si veda tariffe).

Endpoint

Esempio: recupero degli invii

curl "https://app.formuliermet.nl/api/v1/forms/FORM_ID/submissions?limit=2" \
  -H "Authorization: Bearer fmb_je_sleutel_hier"

Risposta

{
  "data": [
    {
      "id": "ckv8s2...",
      "formId": "ckv7a1...",
      "sequenceNumber": 42,
      "status": "paid",
      "amountCents": 2500,
      "email": "deelnemer@example.com",
      "paymentMethod": "ideal",
      "createdAt": "2026-06-01T14:30:00.000Z",
      "updatedAt": null,
      "data": { "naam": "Jan Jansen", "aantal": 2 }
    }
  ],
  "page": 1,
  "limit": 2,
  "total": 42
}

Webhook & eventi in tempo reale

Preferisce che i dati arrivino direttamente a Lei? Configuri i webhook per ogni modulo: inviamo un messaggio JSON tramite POST al Suo URL HTTPS non appena succede qualcosa — oppure a un connettore come Zapier o Make. È possibile anche una notifica per il Suo team, direttamente su Slack o Microsoft Teams.

Eventi da ascoltare

Ogni messaggio è firmato con HMAC-SHA256, in caso di mancata consegna riproviamo automaticamente (con un ritardo crescente fino a diverse ore) e per ogni modulo può consultare un registro delle consegne. I payload esatti, tutti gli header e il codice di verifica pronto all'uso (Node.js & Python) si trovano nella documentazione interattiva.

→ Documentazione API interattiva  ·  Specifica OpenAPI (JSON)

Errori & limiti

Ogni chiave vede esclusivamente i dati del proprio account. Non mostriamo mai le impostazioni del Suo modulo o i collegamenti di pagamento tramite l'API — solo le definizioni dei campi e gli invii.