Server API

Harpy

Outbound HTTP client for server-to-external-API calls — set a base URL and shared headers once, then fire Get/Post/Put/Delete with automatic retry and a chainable Promise API.

Server only | HttpService:RequestAsync is not available on the client. Harpy will error if called from a LocalScript.

Import local harpy = RoExpress.Harpy.New({ baseUrl = "https://api.example.com" })

setup

Configuration

Create a Harpy client with a base URL, shared headers, and retry count. Update any setting at runtime with SetBase, SetHeader, and SetRetries.

Harpy.New(config) →

GET POST PUT DELETE

HTTP Methods

Callback and Promise variants for every HTTP verb. Bodies are JSON-encoded automatically. Every response carries ok, status, data, headers, and raw.

harpy:Get · harpy:Post · harpy:Put · harpy:Delete →

resilience

Retry & Backoff

5xx responses and connection errors trigger automatic exponential backoff. Configure max attempts and delays, or disable retries entirely per client.

retry · backoff · maxAttempts →

Harpy

See also