Gids · 7 min. leestijd
Gids voor de API en automatisering van de formulierbouwer
Bijgewerkt 2026-09-17
Samengevat
Een form-builder-API laat je meestal formulieren aanmaken en beheren met een API-sleutel via REST, op de hoogte blijven van nieuwe antwoorden via ondertekende webhooks in plaats van polling, en biedt steeds vaker een MCP-server zodat AI-codeeragents direct formulieren kunnen aanmaken en lezen.
Zodra een formulier verder gaat dan eenmalig gebruik, wil je het meestal met iets anders verbinden: een script dat programmatisch formulieren aanmaakt, een systeem dat reageert zodra er een antwoord binnenkomt, of een AI-agent die formulieren bouwt en aanpast als onderdeel van een groter werkproces. Deze gids behandelt de drie elementen die dit mogelijk maken: de API zelf, webhooks voor realtime meldingen, en MCP voor toegang door AI-agents.
Authenticeren met een API-sleutel
Een REST API die met API-sleutels is beveiligd, is de standaardmanier om het aanmaken van formulieren te scripten, antwoorden op te lijsten of data naar een ander systeem op te halen, zonder browsersessie. Houd de sleutel serverside; alles wat naar een browser wordt gestuurd is in de praktijk openbaar.
Een OpenAPI-specificatie (een machineleesbare beschrijving van elk endpoint) laat je een clientbibliotheek genereren in de taal van je keuze in plaats van HTTP-aanroepen met de hand te schrijven, en dit is ook wat de meeste API-testtools gebruiken voor autocomplete van verzoeken.
Wat een v1 REST API doorgaans dekt
Verwacht endpoints om formulieren aan te maken en bij te werken, individuele antwoorden op te lijsten en op te halen, en de basisconfiguratie van een formulier te beheren. Versieer de API vanaf dag één (v1, v2) zodat toekomstige breaking changes scripts die tegen de huidige versie zijn gebouwd niet stilzwijgend breken.
Webhooks voor realtime updates
Een API met vaste tussenpozen bevragen om nieuwe antwoorden te controleren verspilt verzoeken en voegt vertraging toe. Een webhook stuurt in plaats daarvan direct content naar je endpoint zodra een antwoord binnenkomt, wat zowel sneller als goedkoper is dan polling.
Ondertekende webhooks (HMAC-SHA256 is de gangbare standaard) laten je endpoint verifiëren dat de content echt van het formulierplatform komt en niet is gemanipuleerd, en automatische nieuwe pogingen bij een mislukte bezorging betekenen dat een korte storing aan jouw kant niet stilzwijgend een inzending verliest.
CSV-export en Slack-meldingen
Niet elke integratie heeft maatwerkcode nodig. CSV-export dekt eenmalige analyse in een spreadsheet, en een Slack-melding bij nieuwe antwoorden dekt het gangbare geval waarin een team simpelweg inzendingen in een kanaal wil zien binnenkomen, zonder iets te hoeven bouwen.
MCP: AI-agents direct met formulieren laten werken
MCP (Model Context Protocol) is een manier voor AI-codeeragents zoals Claude Code, Cursor of ChatGPT om direct tools aan te roepen, in plaats van dat iemand API-antwoorden heen en weer kopieert. Een formulierplatform dat een MCP-server aanbiedt, laat een agent een formulier aanmaken, antwoorden lezen of instellingen aanpassen als onderdeel van een grotere taak, met dezelfde onderliggende API maar via een gestandaardiseerde interface die de agent al weet aan te roepen.
Dit wordt steeds belangrijker voor teams die interne tools bouwen met AI-agents: in plaats van maatwerk-API-integratiecode te schrijven voor een eenmalige formuliertaak, wijs je de agent naar de MCP-server en beschrijf je wat je wilt.
De v1 REST API van YeetForm (documentatie op yeetform.io/developers) authenticeert met API-sleutels, biedt een OpenAPI-specificatie, verstuurt HMAC-SHA256-ondertekende webhooks met automatische nieuwe pogingen bij nieuwe antwoorden, en biedt een MCP-server zodat agents zoals Claude Code, Cursor of ChatGPT direct formulieren kunnen aanmaken en antwoorden kunnen lezen.