HTTP Request Execution
Execute HTTP requests via GET or POST with full control over headers, body, and timeout.
Hoody cURL
Section titled “Hoody cURL”The Hoody cURL service provides a programmable HTTP client for executing, scheduling, and managing outbound HTTP requests. It supports session-based request execution with persistent cookies and authentication, asynchronous job processing for long-running requests, and cron-based scheduling for recurring calls. Responses can be stored as files for later retrieval.
Use these endpoints to monitor service health, scrape metrics, and explore the full feature set linked below.
Service Endpoints
Section titled “Service Endpoints”Session Management
Persist cookies and authentication state across multiple requests within a named session.
Job Management
List, inspect, cancel, and retrieve results for asynchronous HTTP request jobs.
Request Scheduling
Create recurring HTTP requests triggered by cron expressions on a defined schedule.
Storage Management
List, retrieve, and delete response files stored from previous request executions.
Operations
Section titled “Operations”Check service health
Section titled “Check service health”GET /api/v1/curl/health
Returns the standardized service health response. This endpoint is unauthenticated and intended for liveness and readiness probes.
This endpoint takes no parameters.
curl -X GET https://api.hoody.com/api/v1/curl/healthconst health = await client.curl.health.check();{ "status": "ok", "service": "curl", "uptime": 3600, "version": "1.0.0"}Export Prometheus metrics
Section titled “Export Prometheus metrics”GET /metrics
Exports a minimal Prometheus metrics set suitable for scraping by dashboards and alerting systems. Response is returned in Prometheus text exposition format.
This endpoint takes no parameters.
curl -X GET https://api.hoody.com/metricsconst metrics = await client.curl.ops.metrics();# HELP hoody_curl_requests_total Total number of HTTP requests executed# TYPE hoody_curl_requests_total counterhoody_curl_requests_total 12450# HELP hoody_curl_jobs_active Number of active async jobs# TYPE hoody_curl_jobs_active gaugehoody_curl_jobs_active 3