Error Handling

{
  "error": "Human-readable error message",
  "code": "OPTIONAL_ERROR_CODE",
  "details": "Additional context (optional)"
}

{
  "error": "Domain is required"
}

{
  "error": "Invalid domain format"
}

{
  "error": "Invalid email format",
  "details": "The 'from' field must be a valid email address"
}

{
  "error": "Invalid request body: expected string for 'scheduled_at'"
}

HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer realm="API", charset="UTF-8"
Content-Type: application/json; charset=utf-8

{
  "error": "Unauthorized",
  "message": "Authentication required. Provide a valid session cookie or Bearer token.",
  "statusCode": 401
}

{
  "error": "Unauthorized",
  "message": "Authentication required. Provide a valid session cookie or Bearer token.",
  "statusCode": 401
}

{
  "error": "Domain limit reached. Please upgrade your plan to add more domains."
}

{
  "error": "Daily sending limit exceeded. Upgrade your plan for higher limits."
}

{
  "error": "Domain not found"
}

{
  "error": "Email address not found or you don't have access to it"
}

{
  "error": "You have already added this domain to your account"
}

{
  "error": "This domain is already registered on our platform. If you believe this is an error or you need to transfer ownership, please contact our support team.",
  "code": "DOMAIN_ALREADY_REGISTERED"
}

{
  "error": "Email address already exists"
}

{
  "error": "Cannot delete domain. It has 5 associated email addresses. Delete them first."
}

HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 10
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1705315201000
Retry-After: 3
Content-Type: application/json; charset=utf-8

{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Maximum 10 requests per second. Retry after 3 seconds.",
  "statusCode": 429
}

{
  "error": "Failed to create domain"
}

{
  "error": "Failed to send email"
}

HTTP/1.1 503 Service Unavailable
Retry-After: 60
Content-Type: application/json; charset=utf-8

{
  "error": "Service Unavailable",
  "message": "Rate limiting service is temporarily unavailable. Please try again later.",
  "statusCode": 503
}

try {
  const response = await fetch('https://inbound.new/api/e2/domains', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ domain: 'example.com' })
  })
  
  if (!response.ok) {
    const error = await response.json()
    
    switch (response.status) {
      case 400:
        console.error('Validation error:', error.error)
        break
      case 401:
        console.error('Authentication failed - check your API key')
        break
      case 403:
        console.error('Forbidden:', error.error)
        break
      case 404:
        console.error('Not found:', error.error)
        break
      case 409:
        if (error.code === 'DOMAIN_ALREADY_REGISTERED') {
          console.error('Domain already registered by another user')
        }
        break
      case 429:
        const retryAfter = response.headers.get('Retry-After')
        console.error(`Rate limited. Retry after ${retryAfter} seconds`)
        break
      case 500:
        console.error('Server error:', error.error)
        break
    }
    
    throw new Error(error.error)
  }
  
  const data = await response.json()
  console.log('Success:', data)
  
} catch (error) {
  console.error('Request failed:', error)
}

import { Inbound } from 'inboundemail'

const inbound = new Inbound(process.env.INBOUND_API_KEY)

try {
  const domain = await inbound.domains.create({
    domain: 'example.com'
  })
  console.log('Domain created:', domain.id)
  
} catch (error) {
  if (error.status === 409) {
    console.error('Domain already exists')
  } else if (error.status === 400) {
    console.error('Invalid domain:', error.message)
  } else {
    console.error('Error:', error.message)
  }
}

// Server-side logging (visible in console)
console.log("🔍 Checking if domain already exists")
console.log("❌ Domain already exists for current user:", domain)
console.error("❌ Error creating domain:", error)

if (!response.ok) {
  const error = await response.json()
  throw new Error(`API error: ${error.error}`)
}

if (error.code === 'DOMAIN_ALREADY_REGISTERED') {
  // Show specific UI for domain conflicts
} else if (response.status === 403) {
  // Prompt user to upgrade plan
}

async function withRetry(fn: () => Promise<any>, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      return await fn()
    } catch (error) {
      if (error.status === 429 || error.status >= 500) {
        await new Promise(resolve => 
          setTimeout(resolve, Math.pow(2, i) * 1000)
        )
        continue
      }
      throw error // Don't retry client errors
    }
  }
}

catch (error) {
  console.error('API Error:', {
    status: error.status,
    message: error.message,
    code: error.code,
    timestamp: new Date().toISOString()
  })
  
  // Report to error tracking service
  Sentry.captureException(error)
}