HTTP-verzoek

HTTP-aanvraag

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

• Webhook-trigger — Ontvang HTTP-verzoeken

• Code-node — Transformeer API-responsen

---