Error Handling

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human readable message",
    "details": {
      "field": "Additional error context"
    }
  }
}

{
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "Request validation failed",
    "details": {
      "name": "Name is required",
      "email": "Invalid email format"
    }
  }
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Content not found",
    "details": {
      "resourceType": "content",
      "resourceId": "cont123"
    }
  }
}

{
  "error": {
    "code": "COMPONENT_NAME_EXISTS",
    "message": "Component with name 'ProductCard' already exists in this project"
  }
}

{
  "error": {
    "code": "INVALID_STATUS_TRANSITION",
    "message": "Cannot publish deleted content",
    "details": {
      "currentStatus": "deleted",
      "requestedStatus": "published"
    }
  }
}

{
  "error": {
    "code": "COMPONENT_IN_USE_BY_DRAFT",
    "message": "Cannot delete component used by draft content"
  }
}

{
  "error": {
    "code": "CIRCULAR_DEPENDENCY",
    "message": "Package dependency cycle detected",
    "details": {
      "cycle": ["projectA@1.0.0", "projectB@1.0.0", "projectA@1.0.0"]
    }
  }
}

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Too many write requests for this project. Retry in 42s.",
    "details": {
      "operation": "write",
      "limit": 300,
      "windowSeconds": 60,
      "retryAfterSeconds": 42
    }
  }
}

async function fetchContent(id) {
  try {
    const response = await fetch(
      `https://api.metabind.ai/app/v1/organizations/org123/projects/proj456/content/${id}`,
      {
        headers: {
          'Authorization': 'Bearer YOUR_JWT',
          'Content-Type': 'application/json'
        }
      }
    );

    if (!response.ok) {
      const error = await response.json();

      switch (response.status) {
        case 401:
          throw new Error('Authentication required');
        case 403:
          throw new Error('Permission denied');
        case 404:
          throw new Error(`Content ${id} not found`);
        case 429:
          const retryAfter = error.error.details?.retryAfterSeconds ?? response.headers.get('Retry-After') ?? 60;
          throw new Error(`Rate limited. Retry after ${retryAfter}s`);
        default:
          throw new Error(error.error.message);
      }
    }

    return await response.json();
  } catch (error) {
    console.error('API Error:', error.message);
    throw error;
  }
}

async function fetchWithRetry(url, options, maxRetries = 3) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    try {
      const response = await fetch(url, options);

      if (response.status === 429 || response.status >= 500) {
        const delay = Math.pow(2, attempt) * 1000; // 1s, 2s, 4s
        await new Promise(resolve => setTimeout(resolve, delay));
        continue;
      }

      return response;
    } catch (error) {
      if (attempt === maxRetries - 1) throw error;
    }
  }
}