Error Handling

{
  "error": "Invalid API key",
  "code": 401,
  "request_id": "req_abc123xyz"
}

X-RateLimit-Limit: 50          # Requests per second allowed
X-RateLimit-Remaining: 47      # Requests remaining this second
X-RateLimit-Reset: 1704067200  # Unix timestamp when limit resets
X-Credits-Limit: 10000000      # Monthly credit limit
X-Credits-Used: 500000         # Credits used this month
X-Credits-Remaining: 9500000   # Credits remaining this month
X-Credits-Reset: 1706745600    # Unix timestamp for credit reset

import time
import requests

def request_with_retry(url, headers, max_retries=3):
    for attempt in range(max_retries):
        response = requests.get(url, headers=headers)

        if response.status_code == 200:
            return response.json()

        if response.status_code == 429:
            # Rate limited - wait and retry
            reset_time = int(response.headers.get('X-RateLimit-Reset', 0))
            wait = max(reset_time - time.time(), 1)
            time.sleep(wait)
        elif response.status_code >= 500:
            # Server error - exponential backoff
            time.sleep(2 ** attempt)
        else:
            # Client error - don't retry
            response.raise_for_status()

    raise Exception("Max retries exceeded")