{
  "error": {
    "code": "error_code",
    "message": "Human-readable message"
  }
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "Invalid API key"
  }
}

{
  "error": {
    "code": "company_mismatch",
    "message": "Number of company names must match number of files"
  }
}

{
  "error": {
    "code": "invalid_content_type",
    "message": "Content-Type must be multipart/form-data"
  }
}

{
  "error": {
    "code": "no_files",
    "message": "No files provided"
  }
}

{
  "error": {
    "code": "too_many_files",
    "message": "Max 20 files allowed"
  }
}

{
  "error": {
    "code": "payload_too_large",
    "message": "Total size exceeds 4.5 MB"
  }
}

{
  "error": {
    "code": "limit_exceeded",
    "message": "Monthly limit of 250 pages exceeded. Upgrade your plan."
  }
}

{
  "success": false,
  "error": "internal_error",
  "message": "An unexpected error occurred",
  "code": "internal_error",
  "details": {
    "request_id": "req_xyz789"
  }
}

import requests
import time

def upload_with_retry(file_path, max_retries=3):
    for attempt in range(max_retries):
        try:
            with open(file_path, 'rb') as f:
                response = requests.post(
                    'https://lq1qmy4ici.execute-api.ap-southeast-1.amazonaws.com/prod/v1/extract/batch',
                    files={'file': f},
                    data={'user_id': 'ppu_YOUR_USER_ID'},
                    headers={'Authorization': 'Bearer sk_live_YOUR_API_KEY'}
                )
            
            if response.status_code == 429:  # Rate limited
                wait_time = int(response.json()['details']['retry_after'])
                time.sleep(wait_time)
                continue
            
            response.raise_for_status()
            return response.json()
        
        except requests.exceptions.RequestException as e:
            if attempt < max_retries - 1:
                time.sleep(2 ** attempt)  # Exponential backoff
            else:
                raise

upload_with_retry('statement.pdf')

import logging

logger = logging.getLogger(__name__)

try:
    response = requests.post(...)
except Exception as e:
    logger.error(f"Failed to upload: {e}", extra={
        'status_code': response.status_code,
        'error_code': response.json()['code'],
        'request_id': response.json()['details']['request_id']
    })

error_messages = {
    'no_files': 'Please upload at least one file',
    'payload_too_large': 'Files are too large. Max 4.5MB total',
    'limit_exceeded': 'Monthly limit reached. Please upgrade',
    'too_many_files': 'Too many files. Max 20 per request'
}

def handle_error(error_code):
    message = error_messages.get(error_code, 'An error occurred. Please try again')
    return message