Rate Limits

X-RateLimit-Limit: 12000
X-RateLimit-Remaining: 11847
X-RateLimit-Reset: 2024-02-01T00:00:00Z

{
  "error": {
    "code": "quota_exceeded",
    "message": "Monthly API quota exceeded",
    "limit": 12000,
    "reset": "2024-02-01T00:00:00Z"
  }
}

HTTP/1.1 429 Too Many Requests

// Bad: Polling every second
setInterval(() => fetchTasks(), 1000);

// Good: Poll every 5 minutes
setInterval(() => fetchTasks(), 5 * 60 * 1000);

// Better: Use webhooks instead

// Instead of individual task fetches
for (const taskId of taskIds) {
  await fetch(`/tasks/${taskId}`); // 100 calls!
}

// Fetch all tasks in a project at once
await fetch(`/projects/${projectId}/tasks`); // 1 call!

async function apiCall(url, options, retries = 3) {
  const response = await fetch(url, options);

  if (response.status === 429 && retries > 0) {
    // Get reset time from header
    const resetTime = response.headers.get('X-RateLimit-Reset');
    const waitTime = new Date(resetTime) - new Date();

    // If reset is soon, wait. Otherwise, fail.
    if (waitTime < 60000) { // Less than 1 minute
      await sleep(waitTime);
      return apiCall(url, options, retries - 1);
    }
  }

  return response;
}

function checkRateLimits(response) {
  const remaining = parseInt(response.headers.get('X-RateLimit-Remaining'));
  const limit = parseInt(response.headers.get('X-RateLimit-Limit'));
  const usagePercent = ((limit - remaining) / limit) * 100;

  if (usagePercent > 80) {
    console.warn(`API usage at ${usagePercent.toFixed(1)}%`);
    // Alert your team or adjust behavior
  }
}