{
    "type": "https://httpstatuses.com/400",
    "title": "Validation Error",
    "status": 400,
    "detail": "Portal id cannot be empty.",
    "instance": "/api/v1/portals/00000000-0000-0000-0000-000000000000",
    "errors": {
        "validation:invalid_input": [
            "Portal id cannot be empty."
        ]
    },
    "traceId": "ad89db24d04645ed383f4b90c1913602",
    "errorCode": "validation:invalid_input"
}

{
    "type": "https://httpstatuses.com/400",
    "title": "Validation Error",
    "status": 400,
    "detail": "One or more fields are invalid.",
    "instance": "/api/v1/domains/3fa85f64-5717-4562-b3fc-2c963f66afa6/users",
    "errors": {
        "email": [
            "The email field is not a valid email address."
        ],
        "language": [
            "The language klingon is not supported."
        ]
    },
    "traceId": "ad89db24d04645ed383f4b90c1913602",
    "errorCode": "validation:invalid_input"
}

const response = await fetch('https://apirest.yukiworks.be/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');
}