Error Codes

{
  "error": {
    "code": "INVALID_EMAIL",
    "message": "The email address format is invalid",
    "details": {
      "field": "to",
      "value": "invalid-email"
    },
    "request_id": "req_abc123xyz"
  }
}

async function sendEmail(data) {
  try {
    const response = await fetch('/api/emails', {
      method: 'POST',
      headers: {
        'Authorization': 'Bearer ek_live_xxxxxxxxxxxxx',
        'Content-Type': 'application/json',
      },
      body: JSON.stringify(data),
    });

    if (!response.ok) {
      const error = await response.json();
      
      switch (error.error.code) {
        case 'INVALID_EMAIL':
          console.error('Invalid email:', error.error.details.value);
          break;
        case 'RATE_LIMIT_EXCEEDED':
          const retryAfter = response.headers.get('Retry-After');
          console.log(`Retry after ${retryAfter} seconds`);
          break;
        case 'DOMAIN_NOT_VERIFIED':
          console.error('Please verify your domain first');
          break;
        default:
          console.error('API Error:', error.error.message);
      }
      
      return null;
    }

    return response.json();
  } catch (err) {
    console.error('Network error:', err);
    return null;
  }
}

from ekdsend import EKDSend
from ekdsend.exceptions import (
    ValidationError,
    AuthenticationError,
    RateLimitError,
    APIError
)

client = EKDSend('ek_live_xxxxxxxxxxxxx')

try:
    email = client.emails.send(
        from_email='hello@yourdomain.com',
        to='user@example.com',
        subject='Hello',
        html='<p>World</p>'
    )
except ValidationError as e:
    print(f"Validation error: {e.code}")
    print(f"Details: {e.details}")
except AuthenticationError as e:
    print(f"Auth error: {e.message}")
except RateLimitError as e:
    print(f"Rate limited. Retry after {e.retry_after} seconds")
except APIError as e:
    print(f"API error ({e.status_code}): {e.message}")
    print(f"Request ID: {e.request_id}")