Error Handling

{
  "error": "error_code",
  "message": "Human-readable description",
  "field": "field_name",       // Optional: for validation errors
  "details": {}                 // Optional: additional context
}

{
  "error": "unauthorized",
  "message": "Invalid or missing API key"
}

// Ensure header is set correctly
headers: {
  'x-api-key': 'ep_live_xxxxxxxxxxxxxxxxxxxx'  // Not 'Authorization: Bearer ...'
}

{
  "error": "forbidden",
  "message": "Access denied to this endpoint"
}

{
  "error": "not_found",
  "message": "Endpoint '/api/v1/unknown' not found"
}

{
  "error": "validation_error",
  "message": "Field 'text' is required",
  "field": "text"
}

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded. Try again in 45 seconds.",
  "retry_after": 45
}

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1699999999

async function callWithRetry(fn, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      return await fn();
    } catch (error) {
      if (error.status === 429) {
        const retryAfter = error.retryAfter || 60;
        await sleep(retryAfter * 1000);
        continue;
      }
      throw error;
    }
  }
  throw new Error('Max retries exceeded');
}

{
  "error": "internal_error",
  "message": "An unexpected error occurred",
  "request_id": "req_xxxxxxxxxxxx"
}

{
  "error": "provider_error",
  "message": "LLM provider returned an error",
  "details": {
    "provider": "openai",
    "code": "rate_limit_exceeded"
  }
}

{
  "error": "timeout",
  "message": "Request timed out after 60 seconds"
}

async function callWithBackoff(fn, maxRetries = 5) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      return await fn();
    } catch (error) {
      if (error.status === 429 || error.status >= 500) {
        const delay = Math.pow(2, i) * 1000; // 1s, 2s, 4s, 8s, 16s
        await sleep(delay);
        continue;
      }
      throw error; // Don't retry client errors
    }
  }
  throw new Error('Max retries exceeded');
}

try {
  const response = await fetch(url, options);
  const requestId = response.headers.get('X-Request-Id');
  console.log('Request ID:', requestId);
  
  if (!response.ok) {
    const error = await response.json();
    console.error('Error:', error, 'Request ID:', requestId);
    throw error;
  }
} catch (error) {
  // Include request ID in error reports
}

async function handleEndpromptError(error) {
  switch (error.error) {
    case 'validation_error':
      // Show user-friendly validation message
      return `Invalid input: ${error.message}`;
    
    case 'rate_limit_exceeded':
      // Queue for retry
      return 'Service busy, retrying...';
    
    case 'provider_error':
      // Fallback or notify
      return 'AI service temporarily unavailable';
    
    default:
      // Generic error
      return 'Something went wrong. Please try again.';
  }
}