HTTP-verzoek

Overzicht

De HTTP Request-node laat je elke externe API aanroepen - gegevens ophalen, updates verzenden, acties activeren of integreren met diensten die geen native integraties hebben.

Geschikt voor: Aangepaste API-integraties, het ophalen van externe gegevens, het verzenden van webhooks en het verbinden met elke op HTTP gebaseerde service.

Configuratie

Importeer vanuit cURL

Klik op “Import from cURL” om een cURL-opdracht te plakken en automatisch alle velden (URL, methode, headers, parameters) in te vullen. Ideaal om snel verzoeken op te zetten vanuit API-documentatie.

URL (verplicht)

Het API-endpoint dat moet worden aangeroepen. Ondersteunt Auto-, Manual- en Prompt AI-modi.

Voorbeeld in handmatige modus:

https://api.example.com/users/{{trigger.output.user_id}}/orders

Methode

Selecteer de HTTP-methode:

GET: Gegevens ophalen
POST: Nieuwe resources aanmaken
PUT: Bestaande resources vervangen
PATCH: Bestaande resources bijwerken
DELETE: Resources verwijderen

Headers

Voeg aangepaste headers toe als sleutel-waardeparen. Veelvoorkomende headers:

Authenticatie:

Sleutel: Authorization
Waarde: Bearer {{trigger.output.api_token}}

Content Type:

Sleutel: Content-Type
Waarde: application/json

Klik op “Add header” om meerdere headers toe te voegen.

Queryparameters

Voeg URL-queryparameters toe als sleutel-waardeparen in plaats van ze in de URL op te nemen.

Voorbeeld:

URL: https://api.example.com/search
Parameters:
  - Sleutel: query, Waarde: {{trigger.output.search_term}}
  - Sleutel: limit, Waarde: 10

Resultaat in: https://api.example.com/search?query=laptops&limit=10

Body (alleen POST/PUT/PATCH)

De payload van het verzoek, meestal in JSON-formaat. Ondersteunt variabelen uit eerdere nodes.

{
  "name": "{{trigger.output.name}}",
  "email": "{{trigger.output.email}}",
  "status": "{{agent.output.category}}",
  "metadata": {
    "source": "workflow",
    "processed_at": "{{trigger.output.timestamp}}"
  }
}

Voorbeeldgebruikscases

Gebruikersgegevens ophalen (GET)

Methode: GET
URL: https://api.crm.com/users/{{trigger.user_id}}
Headers:
  - Authorization: Bearer YOUR_TOKEN

Record aanmaken (POST)

Methode: POST
URL: https://api.system.com/records
Headers:
  - Content-Type: application/json
Body:
{
  "title": "{{trigger.output.title}}",
  "category": "{{agent.output.category}}",
  "priority": "{{agent.output.priority}}"
}

Zoeken met parameters (GET)

Methode: GET
URL: https://api.example.com/search
Queryparameters:
  - q: {{trigger.search_term}}
  - limit: 20
  - format: json

Status bijwerken (PATCH)

Methode: PATCH
URL: https://api.app.com/items/{{trigger.id}}
Headers:
  - Content-Type: application/json
Body:
{
  "status": "completed",
  "updated_by": "workflow"
}

Toegang tot responsgegevens

Nadat de HTTP-aanvraag is uitgevoerd, kun je de respons in volgende nodes benaderen:

{{http_node.output.status}}              → Statuscode (200, 404, enz.)
{{http_node.output.data}}                → Responsbody
{{http_node.output.data.user.name}}      → Geneste responsgegevens
{{http_node.output.data.items[0].id}}    → Array-items
{{http_node.output.headers}}             → Response-headers

Respons-statuscodes

Gebruik de statuscode om te controleren of het verzoek geslaagd is:

{{ http_node.output.status === 200 }}     → Succes
{{ http_node.output.status >= 400 }}      → Er is een fout opgetreden

Beste praktijken

Gebruik Import from cURL Als je een werkende cURL-opdracht uit de API-docs hebt, gebruik dan “Import from cURL” om automatisch alle velden correct in te stellen.
Fouten afhandelen Voeg altijd foutafhandeling toe. Gebruik een Condition-node na de HTTP Request om te controleren {{ http_node.status === 200 }}.
Gebruik queryparameters Voeg queryparameters toe in de sectie Parameters in plaats van ze hardcoded in de URL te zetten. Dit maakt ze eenvoudiger te beheren.
Test met echte API's Gebruik de testknop van de node om te verifiëren of het verzoek werkt voordat je de rest van je workflow bouwt.

Volgende stappen

VorigeBestandszoektocht VolgendeVoorwaarde