API de Grupos de Acesso
A API de Grupos de Acesso permite listar os grupos de acesso disponíveis no sistema Accessus. É utilizada principalmente para obter o id do grupo necessário na criação de acessos.
Visão Geral
| Método | Endpoint | Descrição |
|---|---|---|
GET | /access-groups | Listar grupos de acesso |
Base URL
Todos os endpoints utilizam o prefixo: /accessus/api/v1
Consultas
Listar Grupos de Acesso
Retorna a lista de grupos de acesso disponíveis para o usuário autenticado, com id e name.
GET/accessus/api/v1/access-groups
Autenticação
| Requisito | Valor |
|---|---|
| Autenticação | Obrigatória |
| Permissão | PERM_API_READ_ACCESS |
Respostas
✅ 200 OK - Lista de grupos retornada
[
{
"id": 1,
"name": "Administrativo"
},
{
"id": 5,
"name": "Visitantes"
}
]
Permissões
Para habilitar as permissões necessárias para utilizar esta API, acesse: Atribuir Permissões ao Papel
| Permissão | Descrição |
|---|---|
PERM_API_READ_ACCESS | Permite consultar acessos |
Atenção
Após habilitar uma permissão no menu Papel, realize o logout do sistema e reinicie a aplicação para que as alterações tenham efeito.