API error codes

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

{
  "detail": "Invalid token"
}

{
  "detail": "Your API token does not allow writes."
}

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

{
  "locale": "The passed locale isn't configured on this account."
}

{
  "query": ["Ensure this field has no more than 100 characters."]
}

{
  "detail": "hero_image is not a valid field to filter by."
}

{
  "detail": "fields is not a valid filter. Format is \"fields.field_id\""
}

{
  "detail": "Invalid filter key hero_image"
}

{
  "detail": "Multiple pages found with slug \"homepage\". Either pass in page_type or ensure only one page has this slug."
}

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

{
  "detail": "Page not found."
}

{
  "detail": "Not found."
}

{
  "detail": "Not found."
}

{
  "detail": "Method \"DELETE\" not allowed."
}

{
  "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;
    }
  }
}

{
  "title": ["This field is required."],
  "slug": ["The slug 'my-post' is not unique!"]
}

["Unknown fields: hero_image"]

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 requests.exceptions import HTTPError

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

try:
    page = client.pages.get('landing-page', 'homepage')
except HTTPError as e:
    # The SDK raises HTTPError(response.status_code) without attaching the
    # response, so only the status code is available here, not the body.
    status_code = e.args[0]
    if status_code == 401:
        print("Authentication failed. Check your API token.")
    elif status_code == 404:
        print("Page not found.")
    elif status_code == 429:
        print("API limit reached. Please wait for the monthly reset.")
    else:
        print(f"Error {status_code}")