Error Handling

{
  "error": {
    "code": "validation_error",
    "message": "Invalid request parameters",
    "details": [
      {
        "field": "origin_country",
        "message": "Must be a valid ISO 3166-1 alpha-2 country code",
        "value": "USA"
      }
    ],
    "request_id": "req_abc123xyz",
    "documentation_url": "https://docs.heydeo.ai/errors#validation_error"
  }
}

from heydeo import HeydeoClient
from heydeo.exceptions import (
    HeydeoError,
    AuthenticationError,
    ValidationError,
    RateLimitError,
    ResourceNotFoundError
)
import time

client = HeydeoClient(api_key="your-api-key")

try:
    shipments = client.shipments.search(
        origin="US",
        destination="CN"
    )
except AuthenticationError as e:
    print(f"Authentication failed: {e.message}")
    print(f"Error code: {e.code}")
    # Update or refresh API key
    
except ValidationError as e:
    print(f"Validation error: {e.message}")
    print(f"Field errors: {e.details}")
    # Fix validation issues
    
except RateLimitError as e:
    print(f"Rate limit exceeded: {e.message}")
    retry_after = e.retry_after or 60
    print(f"Retrying after {retry_after} seconds...")
    time.sleep(retry_after)
    # Retry request
    
except ResourceNotFoundError as e:
    print(f"Resource not found: {e.message}")
    # Handle missing resource
    
except HeydeoError as e:
    print(f"API error: {e.message}")
    print(f"Status: {e.status}")
    print(f"Request ID: {e.request_id}")
    # Handle other API errors
    
except Exception as e:
    print(f"Unexpected error: {str(e)}")
    # Handle non-API errors

async function retryWithBackoff(fn, maxRetries = 3, baseDelay = 1000) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    try {
      return await fn();
    } catch (error) {
      // Don't retry on client errors (4xx except 429)
      if (error.status >= 400 && error.status < 500 && error.status !== 429) {
        throw error;
      }

      // Last attempt, throw error
      if (attempt === maxRetries - 1) {
        throw error;
      }

      // Calculate delay with exponential backoff
      const delay = error.retryAfter 
        ? error.retryAfter * 1000 
        : baseDelay * Math.pow(2, attempt);
      
      console.log(`Retry attempt ${attempt + 1} after ${delay}ms`);
      await new Promise(resolve => setTimeout(resolve, delay));
    }
  }
}

// Usage
const shipments = await retryWithBackoff(() => 
  client.shipments.search({ origin: 'US' })
);

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit of 60 requests per minute exceeded",
    "retry_after": 45,
    "request_id": "req_def456",
    "documentation_url": "https://docs.heydeo.ai/errors#rate_limit_exceeded"
  }
}