X-RateLimit-Limit: 300
X-RateLimit-Remaining: 298
X-RateLimit-Reset: 1705312860
X-RateLimit-Window: 60

{
  "success": false,
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests. Try again in 45 seconds.",
    "retry_after": 45
  }
}

HTTP/1.1 429 Too Many Requests
Retry-After: 45
X-RateLimit-Limit: 300
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1705312860

async function apiCallWithRetry(url, options, maxRetries = 3) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    const response = await fetch(url, options);
    
    if (response.status === 429) {
      const retryAfter = response.headers.get('Retry-After') || 60;
      const delay = Math.min(retryAfter * 1000, Math.pow(2, attempt) * 1000);
      
      console.log(`Rate limited. Retrying in ${delay}ms`);
      await new Promise(r => setTimeout(r, delay));
      continue;
    }
    
    return response;
  }
  
  throw new Error('Max retries exceeded');
}

import time
import requests
from requests.adapters import HTTPAdapter
from urllib3.util.retry import Retry

session = requests.Session()
retries = Retry(
    total=3,
    backoff_factor=1,
    status_forcelist=[429, 500, 502, 503, 504],
    respect_retry_after_header=True
)
session.mount('https://', HTTPAdapter(max_retries=retries))

response = session.get(
    'https://api.usecrew.ai/v1/agents',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

// Bad: 100 individual requests
for (const entry of entries) {
  await api.knowledgeBase.create(entry);
}

// Good: Single batch request
await api.knowledgeBase.createBatch(entries);

const cache = new Map();
const CACHE_TTL = 60000; // 1 minute

async function getAgentsWithCache() {
  const cached = cache.get('agents');
  if (cached && Date.now() - cached.timestamp < CACHE_TTL) {
    return cached.data;
  }
  
  const response = await api.agents.list();
  cache.set('agents', { data: response, timestamp: Date.now() });
  return response;
}

// Bad: Polling every 5 seconds
setInterval(async () => {
  const calls = await api.calls.list({ status: 'active' });
  processActiveCalls(calls);
}, 5000);

// Good: Webhook subscription
// Configure webhook for call.* events
// Process events as they arrive

curl https://api.usecrew.ai/v1/usage/rate-limits \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "current_window": {
    "requests_made": 150,
    "requests_limit": 300,
    "window_reset": "2024-01-15T10:31:00Z"
  },
  "endpoints": {
    "/v1/calls/outbound": {
      "requests_made": 25,
      "requests_limit": 60
    }
  }
}

{
  "success": false,
  "error": {
    "code": "concurrent_limit_exceeded",
    "message": "Maximum concurrent calls reached. Please wait for active calls to complete.",
    "active_calls": 25,
    "limit": 25
  }
}

Time:      t0    t1    t2    t3    t4    t5
Limit:     100   100   100   100   100   100
Requests:  120   90    110   150   80    100
Result:    ✓     ✓     ✓     ✓*    ✓     ✓

* Some requests may be delayed but not rejected