Flow.Documentatie

Bouwsteen: HTTP-aanroep

6 stappen± 4 minVideoGecontroleerd 22 okt 2026
  1. Stap 1 · Open uw ontwikkelomgeving
  2. Stap 2 · Maak een HTTP-aanroep
  3. Stap 3 · Stel de aanroep in
  4. Stap 4 · Test met een ordernummer
  5. Stap 5 · Publiceer een versie
  6. Stap 6 · Geef hem aan een agent

Een HTTP-aanroep is een bouwsteen die één API aanroept, bijvoorbeeld de orderstatus bij een leverancier. U maakt hem één keer, test en publiceert hem; daarna gebruiken workflows hem als stap en agents als tool. De sleutel van de API staat in een verbinding: de server voegt hem toe, de bouwsteen en de agent zien hem nooit.

Bekijk de hele handleiding als video6 stappen in één film
Stap 1 / 6

Open uw ontwikkelomgeving

Klik in de portal bij Omgevingen op Ontwikkeling, en daar op Openen. Flow opent in een nieuw tabblad, en u bent meteen ingelogd.

  1. Klik op Ontwikkeling
Open uw ontwikkelomgeving · Klik op Ontwikkeling
  1. Klik op Openen ↗
Open uw ontwikkelomgeving · Klik op Openen ↗
Stap 2 / 6

Maak een HTTP-aanroep

Klik op + naast Algemeen en kies HTTP-aanroep. Onder Definitie geeft u hem een naam en een omschrijving: een agent leest die omschrijving om te bepalen wanneer hij de tool gebruikt. Voeg een invoerveld toe voor het ordernummer.

  1. Klik op Toevoegen aan Algemeen
Maak een HTTP-aanroep · Klik op Toevoegen aan Algemeen
  1. Klik op HTTP-aanroep
Maak een HTTP-aanroep · Klik op HTTP-aanroep
  1. Vul in bij Naam: Orderstatus bij partner
  2. Vul in bij Omschrijving: Zoekt de status van een bestelling op bij de partner, met het ordernummer.
Maak een HTTP-aanroep · Vul in bij Naam: Orderstatus bij partner; Vul in bij Omschrijving: Zoekt de status van een bestelling op bij de partner, met het ordernummer.
  1. Klik op + Invoerveld
Maak een HTTP-aanroep · Klik op + Invoerveld
  1. Vul in bij Naam: order
Maak een HTTP-aanroep · Vul in bij Naam: order
Stap 3 / 6

Stel de aanroep in

Onder Aanroep kiest u de verbinding met de partner. Het URL-veld wordt dan het pad achter het basisadres van de verbinding. {{input.order}} zet het ordernummer uit de invoer in het pad. Sla het concept op.

  1. Klik op Aanroep
Stel de aanroep in · Klik op Aanroep
  1. Kies bij Verbinding: Partnerportaal · http://127.0.0.1:62354/partner
  2. Vul in bij Pad: /orders/{{input.order}}
Stel de aanroep in · Kies bij Verbinding: Partnerportaal · http://127.0.0.1:62354/partner; Vul in bij Pad: /orders/{{input.order}}
  1. Klik op Concept opslaan
Stel de aanroep in · Klik op Concept opslaan
Stap 4 / 6

Test met een ordernummer

Onder Testen geeft u voorbeeldinvoer en klikt u op Test uitvoeren. De test roept de API echt aan, precies zoals een workflow of agent dat straks doet. U ziet het antwoord van de partner, en in de logs de aanroep met de statuscode.

  1. Klik op Testen
Test met een ordernummer · Klik op Testen
  1. Klik op Code
Test met een ordernummer · Klik op Code
  1. Vul in bij Invoer: {"order": "1042"}
Test met een ordernummer · Vul in bij Invoer: {"order": "1042"}
  1. Klik op ▷ Test uitvoeren
Test met een ordernummer · Klik op ▷ Test uitvoeren
Test met een ordernummer · Geslaagd, met de duur.
Test met een ordernummer · In de logs: GET …/orders/1042 → 200.
Stap 5 / 6

Publiceer een versie

Tevreden? Publiceer een vaste versie. Workflows en agents gebruiken die versie tot u een nieuwe kiest; wat u daarna wijzigt, blijft een concept.

  1. Klik op Versie publiceren →
Publiceer een versie · Klik op Versie publiceren →
Publiceer een versie · Versie v1 is gepubliceerd en actief.
Stap 6 / 6

Geef hem aan een agent

Open een agent. Onder Brein → Tools staan alle gepubliceerde bouwstenen; vink de HTTP-aanroep aan en sla op. Een GET telt als Leest; een aanroep die iets wijzigt (POST, PUT, DELETE) krijgt de agent pas als u schrijven toestaat in de vangrails.

  1. Klik op Agents
Geef hem aan een agent · Klik op Agents
  1. Klik op de agent ‘Orderhulp’
Geef hem aan een agent · Klik op de agent ‘Orderhulp’
  1. Klik op Orderstatus bij partner
Geef hem aan een agent · Klik op Orderstatus bij partner
  1. Klik op Opslaan
Geef hem aan een agent · Klik op Opslaan
Geef hem aan een agent · De bouwsteen staat aan als tool van de agent.

Deze handleiding is op 22 okt 2026 stap voor stap uitgevoerd door een geautomatiseerde test op Flow (versie 3e563176).