Error Codes

interface UnosendError {
  error: {
    code: string;
    message: string;
    status: number;
    details?: Record<string, any>;
  };
}

async function sendEmail(payload: EmailPayload): Promise<EmailResponse> {
  const response = await fetch('https://api.unosend.co/emails', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(payload)
  });
  
  if (!response.ok) {
    const error: UnosendError = await response.json();
    
    switch (error.error.code) {
      case 'invalid_api_key':
      case 'missing_api_key':
        throw new Error('Authentication failed. Check your API key.');
        
      case 'validation_error':
        const fields = error.error.details?.errors
          ?.map((e: any) => `${e.field}: ${e.message}`)
          .join(', ');
        throw new Error(`Validation failed: ${fields}`);
        
      case 'rate_limit_exceeded':
        const retryAfter = error.error.details?.retry_after || 60;
        // Implement retry logic
        await sleep(retryAfter * 1000);
        return sendEmail(payload); // Retry once
        
      case 'domain_not_verified':
        throw new Error('Verify your domain before sending emails.');
        
      case 'quota_exceeded':
        throw new Error('Monthly email quota exceeded. Upgrade your plan.');
        
      case 'internal_server_error':
      case 'service_unavailable':
        // Retry with exponential backoff
        throw new Error('Service temporarily unavailable. Please retry.');
        
      default:
        throw new Error(error.error.message);
    }
  }
  
  return response.json();
}

import requests
import time

class UnosendError(Exception):
    def __init__(self, code, message, status, details=None):
        self.code = code
        self.message = message
        self.status = status
        self.details = details or {}
        super().__init__(message)

def send_email(payload):
    api_key = "un_your_api_key"
    
    response = requests.post(
        "https://api.unosend.co/emails",
        headers={
            "Authorization": f"Bearer {api_key}",
            "Content-Type": "application/json"
        },
        json=payload
    )
    
    if not response.ok:
        error = response.json()["error"]
        
        if error["code"] == "rate_limit_exceeded":
            retry_after = error.get("details", {}).get("retry_after", 60)
            time.sleep(retry_after)
            return send_email(payload)  # Retry
        
        if error["code"] == "validation_error":
            errors = error.get("details", {}).get("errors", [])
            fields = ", ".join([f"{e['field']}: {e['message']}" for e in errors])
            raise UnosendError(
                error["code"],
                f"Validation failed: {fields}",
                error["status"],
                error.get("details")
            )
        
        raise UnosendError(
            error["code"],
            error["message"],
            error["status"],
            error.get("details")
        )
    
    return response.json()

# Check HTTP status code and response
response=$(curl -s -w "\n%{http_code}" -X POST "https://api.unosend.co/emails" \
  -H "Authorization: Bearer un_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"from": "hello@yourdomain.com", "to": "user@example.com", "subject": "Test", "html": "<p>Hello</p>"}')

status=$(echo "$response" | tail -n1)
body=$(echo "$response" | sed '$d')

if [ "$status" -ge 400 ]; then
  echo "Error ($status): $body"
else
  echo "Success: $body"
fi