API error codes

{
  "detail": "Authentication credentials were not provided"
}

{
  "detail": "Invalid token"
}

{
  "detail": "Authentication credentials were not provided"
}

{
  "detail": "levels query parameter should be an integer between 1 and 5 (inclusive)"
}

{
  "detail": "Invalid locale parameter"
}

{
  "detail": "Invalid search query"
}

{
  "detail": "Invalid fields parameter"
}

{
  "detail": "Multiple pages found for the given slug"
}

{
  "detail": "You do not have permission to perform this action"
}

{
  "detail": "Page matching query does not exist"
}

{
  "detail": "Collection matching query does not exist"
}

{
  "detail": "Post matching query does not exist"
}

{
  "detail": "API Calls limit reached."
}

async function fetchWithRetry(url, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      const response = await fetch(url);
      if (response.status === 429) {
        const retryAfter = response.headers.get('Retry-After') || 60;
        console.log(`API limit reached. Retrying in ${retryAfter}s...`);
        await new Promise(r => setTimeout(r, retryAfter * 1000));
        continue;
      }
      return response.json();
    } catch (error) {
      if (i === maxRetries - 1) throw error;
    }
  }
}

{
  "detail": {
    "fields": {
      "title": ["This field is required."],
      "slug": ["A page with this slug already exists."]
    }
  }
}

{
  "detail": "Field 'hero_image' is not defined in this page type"
}

{
  "detail": "An unexpected error occurred. Please try again later."
}

async function safeFetch(fetchFn) {
  try {
    const response = await fetchFn();
    return { data: response.data, error: null };
  } catch (error) {
    const status = error.response?.status;
    const detail = error.response?.data?.detail;

    console.error(`ButterCMS Error [${status}]:`, detail);

    // Handle specific errors
    switch (status) {
      case 401:
        return { data: null, error: 'Authentication failed. Check your API token.' };
      case 404:
        return { data: null, error: 'Content not found.' };
      case 429:
        return { data: null, error: 'API limit reached. Please wait for the monthly reset.' };
      default:
        return { data: null, error: detail || 'An unexpected error occurred.' };
    }
  }
}

from butter_cms import ButterCMS
from butter_cms.exceptions import ButterCMSError

client = ButterCMS('your-api-token')

try:
    page = client.pages.get('landing_page', 'homepage')
except ButterCMSError as e:
    if e.status_code == 401:
        print("Authentication failed. Check your API token.")
    elif e.status_code == 404:
        print("Page not found.")
    elif e.status_code == 429:
        print("API limit reached. Please wait for the monthly reset.")
    else:
        print(f"Error {e.status_code}: {e.message}")