Error Codes Reference

async function handleAPIError(response) {
  if (!response.ok) {
    const errorData = await response.json();
    
    switch (response.status) {
      case 400:
        console.error('Bad request:', errorData.message);
        // Display specific field errors
        if (errorData.errors) {
          errorData.errors.forEach(error => {
            console.error(`Field ${error.field}: ${error.message}`);
          });
        }
        break;
        
      case 401:
        console.error('Authentication failed:', errorData.message);
        // Redirect to login page
        window.location.href = '/login';
        break;
        
      case 403:
        console.error('Insufficient permissions:', errorData.message);
        // Show permission denied message
        alert('You do not have permission to perform this action');
        break;
        
      case 404:
        console.error('Resource not found:', errorData.message);
        break;
        
      case 429:
        console.error('Too many requests:', errorData.message);
        // Implement backoff retry
        setTimeout(() => {
          // Retry request
        }, 5000);
        break;
        
      case 500:
        console.error('Server error:', errorData.message);
        // Show friendly error message
        alert('Server temporarily experiencing issues, please try again later');
        break;
        
      default:
        console.error('Unknown error:', errorData.message);
    }
    
    throw new APIError(response.status, errorData.message, errorData);
  }
  
  return response.json();
}

// Custom error class
class APIError extends Error {
  constructor(status, message, data) {
    super(message);
    this.name = 'APIError';
    this.status = status;
    this.data = data;
  }
}

const response = await fetch('/api/documents', {
  headers: {
    'Authorization': 'Bearer ' + token,
    'X-Debug': 'true'  // Enable debug mode
  }
});

function logError(error, context) {
  const errorLog = {
    timestamp: new Date().toISOString(),
    error: {
      status: error.status,
      message: error.message,
      data: error.data
    },
    context: context,
    userAgent: navigator.userAgent,
    url: window.location.href
  };
  
  // Send to logging service
  console.error('API Error:', errorLog);
  
  // Optional: Send to error monitoring service
  // sendToErrorMonitoring(errorLog);
}

async function retryRequest(requestFn, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      return await requestFn();
    } catch (error) {
      if (i === maxRetries - 1) throw error;
      
      // Don't retry for certain error codes
      if ([400, 401, 403, 404].includes(error.status)) {
        throw error;
      }
      
      // Exponential backoff
      const delay = Math.pow(2, i) * 1000;
      await new Promise(resolve => setTimeout(resolve, delay));
    }
  }
}