The Hoody cURL service provides a programmable HTTP request runner. It lets you execute ad-hoc GET and POST requests, persist session state, track asynchronous jobs, schedule recurring requests via cron, and store response payloads for later retrieval. The service also exposes health and Prometheus metrics endpoints for monitoring.

Available Endpoints

HTTP Request Execution

Execute synchronous HTTP requests via GET or POST. See HTTP Request Execution.

Session Management

Persist cookies and authentication state across requests. See Session Management.

Job Management

List, inspect, cancel, and retrieve results for asynchronous jobs. See Job Management.

Request Scheduling

Create recurring HTTP requests that fire on a cron schedule. See Request Scheduling.

Storage Management

List, retrieve, and delete stored response files. See Storage Management.

Health & Operations

These endpoints expose service health and operational metrics for the cURL service.

GET /api/v1/curl/health

Returns the standardized 9-field health response. Unauthenticated.

This endpoint takes no parameters.

cURL

curl https://api.hoody.com/api/v1/curl/health

SDK

await client.curl.health.check();

200

{
  "status": "ok",
  "service": "curl",
  "built": "2024-01-15T09:00:00Z",
  "started": "2024-01-15T10:00:00Z",
  "memory": null,
  "fds": 42,
  "pid": 1234,
  "ip": "10.0.0.5",
  "userAgent": null
}

GET /metrics

Exports a minimal Prometheus metrics set for dashboards and alerting.

This endpoint takes no parameters.

cURL

curl https://api.hoody.com/metrics

SDK

await client.curl.ops.metrics();

200

# HELP hoody_curl_requests_total Total number of HTTP requests executed
# TYPE hoody_curl_requests_total counter
hoody_curl_requests_total 1024