Handling rate limits gracefully

Overview

SynthLink enforces a 60 req/min rate limit and a 1,000 req/day daily limit. Exceeding either returns a 429 Too Many Requests response with a retry_after field. This guide shows how to handle that gracefully.

Retry with backoff

async function fetchWithRetry(url: string, options: RequestInit, retries = 3) {
  for (let i = 0; i < retries; i++) {
    const res = await fetch(url, options);

    if (res.status !== 429) return res;

    const body = await res.json().catch(() => ({}));
    const wait = (body.retry_after ?? Math.pow(2, i)) * 1000;

    await new Promise((r) => setTimeout(r, wait));
  }

  throw new Error("Max retries exceeded");
}

Preventing rate limit hits

• Cache responses server-side and revalidate on a timer aligned to source update intervals.
• Request only as many records as your UI needs — avoid fetching 100 when you display 10.
• Schedule fetches to align with source cadence rather than polling continuously.