Una sencilla API REST

Primeros pasos

Todas las solicitudes se envían a la URL base y llevan tu clave como token Bearer; la respuesta siempre es application/json. Por cada clave determinas por componente (formularios, envíos) si puede leer o también puede escribir — los permisos de escritura nunca se conceden automáticamente.

URL base

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

Autenticación

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

Crea una clave en la aplicación, en Cuenta → API e integraciones. Solo verás la clave completa una vez — guárdala en un lugar seguro. Una clave da acceso a los datos de tu cuenta; puedes revocarla en cualquier momento. El acceso a la API está incluido en los paquetes más completos (consulta las tarifas).

Endpoints

Ejemplo: obtener envíos

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

Respuesta

{
  "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 y eventos en tiempo real

¿Prefieres que los datos lleguen directamente a ti? Configura webhooks por formulario: enviamos un mensaje JSON mediante POST a tu URL HTTPS en cuanto ocurre algo — o a un conector como Zapier o Make. También puedes recibir un aviso en tu equipo, directamente en Slack o Microsoft Teams.

Eventos a los que puedes suscribirte

Cada mensaje está firmado con HMAC-SHA256; si algo falla, lo reintentamos automáticamente (hasta varias horas) y ves un registro de entregas por formulario. Los payloads exactos, todas las cabeceras y código de verificación listo para usar (Node.js y Python) están en la documentación interactiva.

→ Documentación interactiva de la API  ·  Especificación OpenAPI (JSON)

Errores y límites

Cada clave ve exclusivamente los datos de su propia cuenta. Nunca mostramos la configuración de tu formulario ni tus integraciones de pago a través de la API — solo las definiciones de campos y los envíos.