Eine einfache REST-API

Erste Schritte

Alle Anfragen gehen an die Basis-URL und senden Ihren Schlüssel als Bearer-Token mit; die Antwort ist immer application/json. Pro Schlüssel bestimmen Sie pro Bereich (Formulare, Einreichungen), ob dieser lesen oder auch schreiben darf — Schreibrechte werden nie automatisch erteilt.

Basis-URL

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

Authentifizierung

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

Erstellen Sie einen Schlüssel in der App unter Konto → API & Verbindungen. Sie sehen den vollständigen Schlüssel nur einmal — bewahren Sie ihn sicher auf. Ein Schlüssel gewährt Zugriff auf die Daten Ihres Kontos; Sie können ihn jederzeit widerrufen. Der API-Zugang ist in den größeren Paketen enthalten (siehe Preise).

Endpoints

Beispiel: Einreichungen abrufen

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

Antwort

{
  "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 & Echtzeit-Events

Möchten Sie lieber, dass die Daten zu Ihnen kommen? Richten Sie pro Formular Webhooks ein: Wir senden per POST eine JSON-Nachricht an Ihre HTTPS-URL, sobald etwas passiert — oder an einen Verbindungsdienst wie Zapier oder Make. Eine Benachrichtigung in Ihrem Team ist ebenfalls möglich, direkt an Slack oder Microsoft Teams.

Ereignisse, auf die Sie hören können

Jede Nachricht ist mit HMAC-SHA256 signiert; bei einer Störung versuchen wir es automatisch erneut (ansteigend bis zu mehreren Stunden) und Sie sehen pro Formular ein Zustellprotokoll. Die genauen Payloads, alle Header und fertigen Verifizierungscode (Node.js & Python) finden Sie in der interaktiven Dokumentation.

→ Interaktive API-Dokumentation  ·  OpenAPI-Spezifikation (JSON)

Fehler & Limits

Jeder Schlüssel sieht ausschließlich die Daten des eigenen Kontos. Wir zeigen nie Ihre Formulareinstellungen oder Zahlungsverbindungen über die API — nur die Felddefinitionen und die Einreichungen.