HTTP

Purpose

The HTTP Operator enables the execution of HTTP requests to external APIs and services. It allows for seamless integration with RESTful services by supporting various HTTP methods, custom headers, query parameters, and request bodies.

Use Cases

• Integrating with third-party REST APIs
• Retrieving data from external web services
• Sending data to webhooks
• Performing API-based authentication
• Checking the status of external services
• Triggering actions in external systems

Supported Operations

http-request

Executes an HTTP request to the specified URL.

Input Parameters

• url (string): The target URL for the HTTP request
• method (string): The HTTP method to use (GET, POST, PUT, DELETE, etc.)
• body (JsonNode, optional): The request body in JSON format
• headers (Map<String, String>, optional): HTTP headers to include in the request
• queryParameters (Map<String, String>, optional): Query parameters to append to the URL

Output

Returns a JsonNode containing the response from the HTTP request. The response includes:

• The response body as JSON
• HTTP status code
• Response headers

Example

{
  "url": "https://api.example.com/data",
  "method": "POST",
  "body": {
    "key": "value",
    "nested": {
      "property": "example"
    }
  },
  "headers": {
    "Content-Type": "application/json",
    "Authorization": "Bearer token123"
  },
  "queryParameters": {
    "filter": "active",
    "limit": "10"
  }
}