{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable message",
    "details": {
      // Additional context (optional)
    }
  }
}

interface ApiError {
  error: {
    code: string;
    message: string;
    details?: Record<string, unknown>;
  };
}

async function fetchApi(url: string, token: string) {
  const response = await fetch(url, {
    headers: { 'Authorization': `Bearer ${token}` }
  });

  if (!response.ok) {
    const error: ApiError = await response.json();
    
    switch (error.error.code) {
      case 'UNAUTHORIZED':
        throw new Error('Invalid API token. Please check your credentials.');
      case 'RATE_LIMITED':
        const resetAt = error.error.details?.reset_at as number;
        throw new Error(`Rate limited. Try again at ${new Date(resetAt * 1000)}`);
      case 'NOT_FOUND':
        throw new Error(`Resource not found: ${error.error.message}`);
      default:
        throw new Error(error.error.message);
    }
  }

  return response.json();
}

import requests
from datetime import datetime

def fetch_api(url: str, token: str):
    response = requests.get(url, headers={'Authorization': f'Bearer {token}'})
    
    if not response.ok:
        error = response.json()['error']
        
        if error['code'] == 'UNAUTHORIZED':
            raise Exception('Invalid API token. Please check your credentials.')
        elif error['code'] == 'RATE_LIMITED':
            reset_at = datetime.fromtimestamp(error['details']['reset_at'])
            raise Exception(f"Rate limited. Try again at {reset_at}")
        elif error['code'] == 'NOT_FOUND':
            raise Exception(f"Resource not found: {error['message']}")
        else:
            raise Exception(error['message'])
    
    return response.json()