{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable error message",
    "details": "Additional context or suggestions",
    "requestId": "unique-request-identifier",
    "timestamp": "2024-01-15T10:30:00Z"
  }
}

{
  "error": {
    "code": "INVALID_API_KEY",
    "message": "The provided API key is invalid",
    "details": "Please check your API key and ensure it's correctly formatted",
    "requestId": "req_123456789",
    "timestamp": "2024-01-15T10:30:00Z"
  }
}

{
  "error": {
    "code": "INVALID_ENUM_VALUE",
    "message": "Invalid value for documentType parameter",
    "details": "documentType must be one of: law, regulation, directive, decree, circular, guideline",
    "requestId": "req_123456790",
    "timestamp": "2024-01-15T10:30:00Z"
  }
}

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded",
    "details": "You have exceeded the rate limit of 100 requests per hour. Please wait before making additional requests.",
    "requestId": "req_123456791",
    "timestamp": "2024-01-15T10:30:00Z"
  }
}

{
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "An unexpected error occurred",
    "details": "Please try again later. If the problem persists, contact support.",
    "requestId": "req_123456792",
    "timestamp": "2024-01-15T10:30:00Z"
  }
}

const response = await fetch("/api/legislation");
if (!response.ok) {
  const error = await response.json();
  console.error("API Error:", error.error.message);
}

if (response.status === 429) {
  const retryAfter = response.headers.get("Retry-After");
  console.log(`Rate limited. Retry after ${retryAfter} seconds`);
}

async function makeRequestWithRetry(url, options, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      const response = await fetch(url, options);
      if (response.ok) return response;

      if (response.status >= 500 && i < maxRetries - 1) {
        await new Promise((resolve) =>
          setTimeout(resolve, 1000 * Math.pow(2, i))
        );
        continue;
      }

      throw new Error(`Request failed: ${response.status}`);
    } catch (error) {
      if (i === maxRetries - 1) throw error;
    }
  }
}

const error = await response.json();
console.log(`Request ID for support: ${error.error.requestId}`);