Tratamento de Erros

{
  "error": "VALIDATION_ERROR",
  "message": "Campo obrigatório ausente",
  "details": {
    "field": "nu_cpf",
    "reason": "required"
  }
}

{
  "error": "INVALID_TOKEN",
  "message": "Token expirado ou inválido",
  "details": {}
}

{
  "error": "INSUFFICIENT_SCOPE",
  "message": "Permissão insuficiente para esta operação",
  "details": {
    "required_scope": "admin"
  }
}

{
  "error": "RESOURCE_NOT_FOUND",
  "message": "Proposta não encontrada",
  "details": {
    "resource": "proposta",
    "id": "123456"
  }
}

{
  "error": "BUSINESS_RULE_VIOLATION",
  "message": "Margem insuficiente para o valor solicitado",
  "details": {
    "margem_disponivel": 350.00,
    "parcela_solicitada": 500.00
  }
}

{
  "error": "RATE_LIMITED",
  "message": "Limite de requisições excedido. Tente novamente em 60s",
  "details": {
    "retry_after": 60
  }
}

{
  "error": "INTERNAL_ERROR",
  "message": "Erro interno. Contate o suporte com o correlation_id",
  "details": {
    "correlation_id": "abc-123-def-456"
  }
}