Error Handling

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable error description",
    "details": {
      "field": "specific_field",
      "issue": "Detailed issue description"
    }
  }
}

const response = await fetch('https://api.bit2connect.com/api/links', {
  headers: { 'Authorization': 'Bearer b2co_your_api_key' }
});

const data = await response.json();

if (!data.success) {
  console.error('API Error:', data.error.code, data.error.message);
  // Handle error appropriately
}

switch (data.error.code) {
  case 'INVALID_API_KEY':
    // Redirect to API key setup
    break;
  case 'RATE_LIMIT_EXCEEDED':
    // Implement exponential backoff
    break;
  case 'LINK_NOT_FOUND':
    // Show user-friendly "not found" message
    break;
  default:
    // Generic error handling
}

async function apiCallWithRetry(url, options, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      const response = await fetch(url, options);
      const data = await response.json();
      
      if (data.success) {
        return data;
      }
      
      // Don't retry client errors (4xx)
      if (response.status >= 400 && response.status < 500) {
        throw new Error(data.error.message);
      }
      
      // Retry server errors with exponential backoff
      if (i < maxRetries - 1) {
        await new Promise(resolve => 
          setTimeout(resolve, Math.pow(2, i) * 1000)
        );
      }
    } catch (error) {
      if (i === maxRetries - 1) throw error;
    }
  }
}

console.error('Bit2Connect API Error:', {
  endpoint: url,
  method: options.method,
  statusCode: response.status,
  errorCode: data.error.code,
  errorMessage: data.error.message,
  requestId: response.headers.get('x-request-id')
});

if (response.status === 429) {
  const resetTime = response.headers.get('X-RateLimit-Reset');
  const waitTime = (resetTime * 1000) - Date.now();
  console.log(`Rate limited. Retry after ${waitTime}ms`);
}