{
    "type": "https://httpstatuses.com/422",
    "title": "Validation Error",
    "status": 422,
    "errors": {
        "validation:invalid_input": [
            "The email field is not a valid email address."
        ]
    },
    "traceId": "00-ad89db24d04645ed383f4b90c1913602-0b19ca914794928b-00",
    "errorCode": "validation:invalid_input"
}

const response = await fetch('https://api.yukisoftware.com/v1/administrations', {
  headers: { Authorization: `Bearer ${accessToken}` }
});

if (!response.ok) {
  const body = await response.json();
  console.error(`[${body.errorCode}] ${body.title} (traceId: ${body.traceId})`);

  switch (body.errorCode) {
    case 'authentication:unauthorized':
      // Token missing, invalid or expired — redirect to login and re-authenticate
      break;
    case 'authentication:forbidden':
      // User lacks permission — show access denied message
      break;
    case 'validation:invalid_input':
    case 'validation:missing_required_field':
      // Surface the per-field messages to the user
      console.error(body.errors);
      break;
    case 'companies:not_found':
    case 'domains:not_found':
    case 'portals:not_found':
      // Resource does not exist — handle gracefully
      break;
    default:
      // Generic fallback — log traceId for support
      console.error('traceId:', body.traceId);
      break;
  }
}

async function fetchWithRetry(url, options, maxRetries = 3) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    const response = await fetch(url, options);
    if (response.status !== 429 && response.status !== 503) {
      return response;
    }
    // Wait before retrying: 1s, 2s, 4s ...
    const delay = Math.pow(2, attempt) * 1000;
    await new Promise(resolve => setTimeout(resolve, delay));
  }
  throw new Error('Max retries reached');
}