rate-limited

Status	429
Title	Rate limit exceeded
Code	rate-limited
Type	https://docs.satellitedata.net/problems/rate-limited

Available now Lean v1 can return this problem.

Meaning

The key is sending requests faster than its limit.

Likely causes

• In lean v1, more than 50 requests a second per key (bursts of 100), or 100 a second across the service. A map that pans fast can get there.
• Later, more than the tier’s units a minute (300 on free) or 600 requests a minute.

Fix

Wait for Retry-After seconds (1 in lean v1), then back off exponentially with jitter. See Limits.

Example

The detail is the example from the v1 contract.

{
  "type": "https://docs.satellitedata.net/problems/rate-limited",
  "title": "Rate limit exceeded",
  "status": 429,
  "detail": "This key spent 300 of its 300 units in the current minute.",
  "instance": "/v1/...",
  "code": "rate-limited",
  "requestId": "01JQ7Z3M8R5V2W6X9Y0A1B2C3D"
}

See Errors for the members every problem carries.