Consulta os perfis de acesso com base nos filtros fornecidos. - API Zen 2

Este endpoint permite consultar informações sobre os perfis de acesso cadastrados no sistema.
O parâmetro TotalRegistros pode ser utilizado para limitar o número de registros retornados.
A consulta retorna um conjunto de perfis de acesso que atendem aos filtros fornecidos.

Validações:

Verifica se o número total de registros solicitado não ultrapassa 500.

Respostas:

Sucesso: Retorna a lista de perfis de acesso conforme os filtros aplicados.

Falhas: Detalha os erros, como número de registros excedente ou falhas na validação dos filtros.

Exemplo de Requisição (GET com parâmetros na URL):

Valores e Descrições dos Enums:

Enum TipoAmbiente

Valor	Descrição
1	Escritório
2	Empresa
3	Suporte

Enum AtivoInativoEnum

Valor	Descrição
1	Ativo
2	Inativo

Exemplo de Resposta de Sucesso (200 - OK):

{
  "sucesso": true,
  "mensagens": "Consulta realizada com sucesso",
  "dados": [
    {
      "Id": 1,
      "NomePerfil": "Administrador",
      "Descricao": "Perfil de acesso de administrador"
    },
    {
      "Id": 2,
      "NomePerfil": "Usuário",
      "Descricao": "Perfil de acesso de usuário"
    }
  ]
}

Exemplo de Resposta de Erro (400 - Bad Request):

{
  "sucesso": false,
  "mensagens": "Erro de validação nos dados fornecidos",
  "dados": null
}