Error Codes Reference

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable description",
    "details": {
      "field": "Additional context"
    }
  },
  "request_id": "req_abc123xyz"
}

async function captureScreenshot(url) {
  try {
    const response = await fetch('https://api.screencraft.dev/v2/screenshot', {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${API_KEY}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({ url }),
    });

    const data = await response.json();

    if (!response.ok) {
      // Handle specific errors
      switch (data.error.code) {
        case 'RATE_LIMITED':
          // Implement exponential backoff
          const retryAfter = response.headers.get('Retry-After') || 60;
          await sleep(retryAfter * 1000);
          return captureScreenshot(url); // Retry

        case 'TIMEOUT':
          // Use async endpoint for slow pages
          return captureScreenshotAsync(url);

        case 'QUOTA_EXCEEDED':
          // Alert user to upgrade
          throw new Error('Monthly quota exceeded. Please upgrade your plan.');

        default:
          throw new Error(data.error.message);
      }
    }

    return data.data;
  } catch (error) {
    console.error('Screenshot failed:', error);
    throw error;
  }
}

async function withRetry(fn, maxRetries = 3) {
  let lastError;

  for (let attempt = 1; attempt <= maxRetries; attempt++) {
    try {
      return await fn();
    } catch (error) {
      lastError = error;

      // Don't retry on client errors (4xx)
      if (error.status >= 400 && error.status < 500) {
        throw error;
      }

      // Exponential backoff
      const delay = Math.min(1000 * Math.pow(2, attempt), 30000);
      console.log(`Attempt ${attempt} failed, retrying in ${delay}ms...`);
      await new Promise(resolve => setTimeout(resolve, delay));
    }
  }

  throw lastError;
}