API-antwoord: wat de aanroeper terugkrijgt
Staat een workflow achter een endpoint, dan bepaalt de stap API-antwoord wat de aanroeper terugkrijgt: de HTTP-status en de body, met gegevens uit de workflow. Zonder API-antwoord krijgt de aanroeper alles wat de workflow verzamelde. U bouwt het antwoord, publiceert de workflow als endpoint en roept hem aan zoals een afnemer dat doet.
Open Flow en maak een workflow
Klik in de portal bij Omgevingen op Ontwikkeling en daar op Openen; Flow opent in een nieuw tabblad. Klik daar op ＋ naast Algemeen, kies Nieuwe workflow en geef hem een naam. Een nieuwe workflow begint met een Event trigger: het punt waar hij start.
- Klik op Ontwikkeling
- Klik op Openen ↗
- Klik op Toevoegen aan Algemeen
- Klik op Nieuwe workflow
- Vul in bij Workflownaam:
Gids · aanmelding ontvangen
Bouw het antwoord
Zet in de voorbeeldgegevens wat een aanroeper meestuurt. Voeg API-antwoord toe. Kies de HTTP-status: 201 betekent aangemaakt. In de body (Code) zet u wat de aanroeper terugkrijgt, met {{veld}} voor gegevens uit de aanvraag.
- Klik op de stap ‘Event trigger’
- Klik op Code
- Vul in bij de voorbeeldgegevens: `{
- Klik op Node toevoegen
- Klik op API-antwoord
- Vul in bij HTTP-status:
201
- Klik op Code
- Vul in bij de body: `{
- Klik op het bolletje van ‘Event trigger’
- Klik op het bolletje van ‘API-antwoord’
Zet de stappen op één lijn en sla op
Selecteer de stappen (klik de eerste, en de andere met Shift ingedrukt) en klik op Horizontaal uitlijnen: dan staan ze op één lijn en leest u de workflow van links naar rechts; een tak (zoals Nee van een If / Else) krijgt een eigen rij eronder. Passend maken zet alles in beeld; daarna Opslaan.
- Klik op ‘Event trigger’
- Klik op ‘API-antwoord’ met Shift ingedrukt
- Klik op Horizontaal uitlijnen
- Klik op Passend maken
- Klik op Opslaan
Probeer het in de Studio
Voer uit: onderin staat dat het antwoord klaargezet is, met de status. Onder Gegevens na de run ziet u het als response.status en response.body.
- Klik op Voer uit
Publiceer de workflow als endpoint
Druk op Esc: zonder geselecteerde stap staan de Workflow-instellingen rechts. Onder Publiceer als endpoint kiest u een nieuwe API, met een naam; de methode POST past bij iets aanmaken. Klik op Publiceren: het endpoint opent.
- Kies bij API: ＋ Nieuwe API…
- Vul in bij Naam van de nieuwe API:
Gids · aanmeldingen
- Klik op Publiceren
Roep het endpoint aan
Rechts staat Proberen: dat roept de API aan zoals een afnemer, met een sleutel (hier afgedekt). Zet in de body wat de afnemer meestuurt en klik op Verstuur. U krijgt 201 terug, met precies de body uit API-antwoord.
- Vul in bij Sleutel of token:
••••••••
- Klik op Code
- Vul in bij Body:
{"naam": "Ada Straat", "personen": 2}
- Klik op ▶ Verstuur
Deze handleiding is op 22 okt 2026 stap voor stap uitgevoerd door een geautomatiseerde test op Flow (versie 3e563176).