HTTP Request Execution
Make one-shot HTTP requests via GET or POST. Send headers, a body, and follow redirects on demand.
The Hoody cURL service is a containerized HTTP client that lets you execute, persist, schedule, and inspect HTTP requests from your Hoody workspace. It supports cookie-bearing sessions, long-running async jobs, cron-style scheduling, and binary response storage. This page covers the operational endpoints for the service itself; the user-facing capabilities live on the sub-pages below.
Sub-pages
Section titled “Sub-pages”Session Management
Create named sessions that persist cookies and authentication state across multiple requests.
Job Management
List, inspect, cancel, and fetch results for asynchronous HTTP request jobs.
Request Scheduling
Create recurring HTTP requests driven by cron expressions. Useful for polling external APIs or webhooks.
Storage Management
List, retrieve, and delete response files stored by previous cURL executions.
Operational Endpoints
Section titled “Operational Endpoints”The two endpoints below are used to monitor and observe the cURL service itself. They do not require authentication.
GET /api/v1/curl/health
Section titled “GET /api/v1/curl/health”Returns the standardized service health response. Unauthenticated.
This endpoint takes no parameters.
curl https://{projectId}-{containerId}-curl-1.{server}.containers.hoody.icu/api/v1/curl/healthawait client.curl.health.check();{ "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
Section titled “GET /metrics”Exports a minimal Prometheus metrics set for dashboards and alerting. Unauthenticated.
This endpoint takes no parameters.
curl https://{projectId}-{containerId}-curl-1.{server}.containers.hoody.icu/metricsawait client.curl.ops.metrics();# HELP curl_requests_total Total number of HTTP requests executed# TYPE curl_requests_total countercurl_requests_total 0