Appearance
API Overview
Our API lives under a single versioned host:
https://ws.latency.app/v1/Some endpoints are public; others require authentication. Either way, calls are rate-limited, see below.
Limits
Details in rate limits. Every caller is metered so no single caller can starve the rest. Calls over a limit receive 429 Too Many Requests with a body of { "error": "rate_limited" } and a Retry-After header (seconds). Back off and retry.
Authenticate for real workloads
The public budgets are sized for interactive and light programmatic use. Services and high-volume callers should use an API key: account calls run against plan quotas and skip the anonymous budget. The DNS resolver is the deliberate exception and stays free. Full breakdown on platform primitives → rate limits.
Errors
Failures return a non-2xx status and a JSON body of the shape { "error": "<code>" }, sometimes with a detail field. Secrets never belong in a URL; API keys go in the Authorization header.