Frequentie gebruik:
Moeilijkheidsgraad:
De Endpoint kan gebruikt worden om vanaf een andere API data te sturen naar Flow! Dit is ontzettend interessant voor externe partijen die willen koppelen met AFAS maar geen zin/tijd hebben om de complexiteit van AFAS te leren kennen en/of de business logica goed te ondervangen.
De werking:
- Een externe partij (bijvoorbeeld Website) stuurt ‘platte’ data naar Flow
- Flow doet vervolgens allerlei (zelf te definieren) business logica toepassen
- Flow voert eventueel andere GetConnectoren uit, voert één of meerdere UpdateConnectoren uit
- Flow kan een response (met data) terugsturen naar de andere partij.
Flow is dus ideaal in te zetten als middleware tussen applicatie X en AFAS.
In een EndPoint Flow kunnen alle acties van Flow gebruikt worden.
Een Endpoint flow bouwen
Het bouwen van een Endpoint flow start met het maken van een nieuw Flow. Kies “Endpoint start” als startactie.
Geef de input op in JSON code welke gebruikt wordt bij een lege aanroep én testdoeleinden. In ons voorbeeld:
{
"name": "Doe",
"firstname" : "John"
}
Je kunt er nu voor kiezen om extra acties toe te voegen. Bijvoorbeeld het aanmaken van een klant op basis van deze naam. In dit geval hebben we ook ‘Endpoint Response’ toegevoegd. Met deze actie wordt naast de status gelukt/mislukt, ook de output meegegeven. Let op: je kunt maar 1 Endpoint Response toevoegen. Wil je op meerdere plekken een response geven, gebruik dan een uitvoeren actie in combinatie met een mapping om je input te formatteren.
Sla de flow op. Je hebt nu een basis Endpoint Flow ingericht die een persoon aanmaakt o.b.v. een voornaam en een achternaam. Uiteraard kun je zelf een hoop acties toevoegen.
Een endpoint flow activeren
Een Endpoint flow activeer je in tabblad “Flow Planner”.
- Kies voor “Nieuw Endpoint”.
- Selecteer de Flow (zie je jouw flow niet? Controleer dan of de startactie wel Endpoint start is en de flow niet per ongeluk ook is ingepland)
- kies aanvragen
- Sla de token die je hebt ontvangen veilig op. Deze heeft de andere applicatie nodig.
Een endpoint flow aanroepen
De endpoint flow kan door een andere applicatie eenvoudig aangeroepen worden. Voor testdoeleinden is Postman goed te gebruiken.
De gegevens zijn als volgt:
Method: "POST"
URL: "<Endpoint URL>"
Headers:
x-api-key: "<Endpoint API key>"
Content-Type: "application/json"
Body: "<JSON object om te gebruiken als input>"
XML als response
Alhoewel we vinden dat JSON de enige juiste taal is wordt XML ook deels ondersteund. Het is mogelijk om het endpoint te laten aanroepen en een XML bericht terug te sturen.
Hoe dit werkt:
- Zorg ervoor dat je in één veld de XML ombouwt. Bijvoorbeeld met “Nieuwe Tekst” of “Mapping”. Plaats de structuur van de XML en vul de ‘waarden’ met Flow variabelen
- Kies in de Endpoint Response voor de optie “Veld als waarde”. Kies vervolgens het nieuw gecreëerde veld.
Zie ook het voorbeeld in Postman:
Endpoint activeren via een webpagina (experimenteel)
Het is mogelijk om een endpoint te starten via een webpagina. Deze functionaliteit wordt in 2026 beschikbaar gemaakt in Flow. Voor nu kun je deze al gebruiken via een URL. Deze methode is experimenteel.
URL Encode (experimenteel)
Sommige webhooks sturen hun informatie “Form_Encoded” door. Flow verwacht standaard en JSON input. Indien de data wordt opgestuurd als Form_Encoded ziet dit eruit als een Byte_Array. Om dit voorkomen kun je in de endpoint URL de volgende toevoeging doen: ?method=formEncode