Estructura de errores

La API devuelve errores en dos formatos según el tipo de falla. El formato simple se usa para errores de negocio; el formato detallado aparece cuando la validación del modelo del request falla (ASP.NET ProblemDetails).

Formato simple


{ "error": "Producto 999 no encontrado." }

Formato detallado (validación de modelo)


{
  "type": "https://tools.ietf.org/html/rfc7231#section-6.5.1",
  "title": "One or more validation errors occurred.",
  "status": 400,
  "errors": {
    "Lineas": ["The Lineas field is required."],
    "Cliente.IdCliente": ["The IdCliente field must be greater than 0."]
  }
}

Recomendación para el cliente


function extractError(response) {
  if (response.data?.error) return response.data.error;
  if (response.data?.errors) {
    return Object.entries(response.data.errors)
      .map(([campo, mensajes]) => `${campo}: ${mensajes.join(', ')}`)
      .join('; ');
  }
  return `HTTP ${response.status}`;
}