Une API REST simple

Pour commencer

Toutes les requêtes sont envoyées à l'URL de base et transmettent votre clé comme jeton Bearer ; la réponse est toujours au format application/json. Pour chaque clé, vous déterminez par composant (formulaires, soumissions) si elle peut lire ou aussi écrire — les droits d'écriture ne sont jamais accordés automatiquement.

URL de base

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

Authentification

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

Créez une clé dans l'application, sous Compte → API & intégrations. Vous ne voyez la clé complète qu'une seule fois — conservez-la en lieu sûr. Une clé donne accès aux données de votre compte ; vous pouvez la révoquer à tout moment. L'accès à l'API est inclus dans les formules les plus complètes (voir tarifs).

Endpoints

Exemple : récupérer des soumissions

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

Réponse

{
  "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
}

Webhooks & événements en temps réel

Vous préférez recevoir les données directement chez vous ? Configurez des webhooks par formulaire : nous envoyons une requête POST avec un message JSON vers votre URL HTTPS dès qu'un événement se produit — ou vers un outil comme Zapier ou Make. Une notification à votre équipe est également possible, directement dans Slack ou Microsoft Teams.

Événements à écouter

Chaque message est signé avec HMAC-SHA256, en cas d'échec nous réessayons automatiquement (avec un délai croissant, jusqu'à plusieurs heures) et vous consultez un journal de livraison par formulaire. Les payloads exacts, tous les en-têtes et du code de vérification prêt à l'emploi (Node.js & Python) se trouvent dans la documentation interactive.

→ Documentation API interactive  ·  Spécification OpenAPI (JSON)

Erreurs & limites

Chaque clé ne voit que les données de son propre compte. Nous n'exposons jamais vos paramètres de formulaire ni vos connexions de paiement via l'API — uniquement les définitions de champs et les soumissions.