Http Request Skill

HTTP Request Tool

Make HTTP requests to external APIs and web services.

How It Works

This skill provides instructions for the HTTP Request tool node. Connect the HTTP Request node to Zeenie's input-tools handle to enable API calls.

http_request Tool

Make an HTTP request to any URL.

Schema Fields

Node Parameters

Additional options can be configured on the node:

Response Format

jsonCopy code
{
  "status": 200,
  "data": { "key": "value" },
  "url": "https://api.example.com/data",
  "method": "GET",
  "proxied": false
}

Examples

GET request (fetch data):

jsonCopy code
{
  "url": "https://api.example.com/users/123",
  "method": "GET"
}

POST request (create resource):

jsonCopy code
{
  "url": "https://api.example.com/users",
  "method": "POST",
  "body": {
    "name": "John Doe",
    "email": "john@example.com"
  }
}

PUT request (update resource):

jsonCopy code
{
  "url": "https://api.example.com/users/123",
  "method": "PUT",
  "body": {
    "name": "John Updated"
  }
}

DELETE request:

jsonCopy code
{
  "url": "https://api.example.com/users/123",
  "method": "DELETE"
}

PATCH request (partial update):

jsonCopy code
{
  "url": "https://api.example.com/users/123",
  "method": "PATCH",
  "body": {
    "status": "active"
  }
}

Real-World Examples

Get Bitcoin price:

jsonCopy code
{
  "url": "https://api.coindesk.com/v1/bpi/currentprice.json",
  "method": "GET"
}

Get weather:

jsonCopy code
{
  "url": "https://api.openweathermap.org/data/2.5/weather?q=London&appid=YOUR_KEY",
  "method": "GET"
}

Post to webhook:

jsonCopy code
{
  "url": "https://hooks.slack.com/services/xxx",
  "method": "POST",
  "body": {
    "text": "Hello from OpenCompany!"
  }
}

Check website status:

jsonCopy code
{
  "url": "https://example.com",
  "method": "GET"
}

Error Responses

Timeout:

jsonCopy code
{
  "error": "Request timed out"
}

Connection failed:

jsonCopy code
{
  "error": "Connection failed: Unable to reach host"
}

HTTP error:

jsonCopy code
{
  "status": 404,
  "data": "Not Found",
  "url": "https://api.example.com/missing",
  "method": "GET"
}

HTTP Status Codes

Use Cases

Proxy Usage

To route a request through a residential proxy, just set useProxy: true. The proxy service automatically selects the best provider, geo-target, and session type from its configuration. A proxy provider must be configured first via the proxy_config tool (see proxy-config-skill).

Proxied request:

jsonCopy code
{
  "url": "https://example.com/data",
  "method": "GET",
  "useProxy": true
}

If no proxy providers are configured or the proxy lookup fails, the request proceeds directly without a proxy and "proxied": false appears in the response.

Guidelines

1. URLs: Must be fully qualified with protocol (https://)
2. Authentication: Use node headers for API keys/tokens
3. Timeout: Default 30 seconds
4. JSON body: Automatically serialized for POST/PUT/PATCH
5. Response: JSON responses are automatically parsed
6. Proxy: Set useProxy: true to route through proxy -- the proxy service handles all routing details

Security Notes

1. Never expose API keys in responses to users
2. Validate URLs before making requests
3. Avoid internal/private network addresses (localhost, 192.168.x.x)
4. Respect rate limits of external services
5. Don't store sensitive data from API responses

Setup Requirements

1. Connect the HTTP Request node to Zeenie's input-tools handle
2. Configure authentication headers on the node if needed
3. Ensure network access to target APIs
4. For proxy usage: configure a proxy provider via the proxy-config-skill first