Plantonizei

Painel da empresa › Permissões

Perfis e exceções de permissão

GET/api/v1/permissionsPede sessão

Como funciona

Tudo que a tela de Permissões precisa: os módulos do painel (modules, com chave e nome), os perfis de permissão da empresa (profiles, cada um com o que libera em cada módulo) e as exceções individuais (exceptions).

A permissão efetiva de uma pessoa sai do perfil dela, ajustado pelas exceções que valem só para ela. Pede a permissão de ver permissões.

Respostas

200 · modules, profiles e exceptions.

  • exceptionsobject[] · Exceções individuais de permissão.
  • exceptions[].actionstring · O que foi feito.
  • exceptions[].effectstring · Efeito da exceção: allow libera, deny bloqueia.
  • exceptions[].grantedAtstring · Quando foi concedido.
  • exceptions[].grantedBystring · Quem concedeu.
  • exceptions[].idstring · Identificador do registro.
  • exceptions[].moduleKeystring · Chave do módulo do painel.
  • exceptions[].reasonstring · Motivo.
  • exceptions[].userIdstring · Identificador da conta da pessoa.
  • exceptions[].userNamestring · Nome de quem fez a ação.
  • modulesobject[] · Módulos.
  • profilesobject[] · Perfis de permissão.
  • profiles[].baseRolestring · Papel em que o perfil se baseia.
  • profiles[].builtInboolean · Item da plataforma.
  • profiles[].descriptionstring · Descrição.
  • profiles[].idstring · Identificador do registro.
  • profiles[].labelstring · Nome exibido.
  • profiles[].lockedboolean · A escala está travada para o fechamento.
  • profiles[].modulesobject · Módulos.

Corpo de exemplo

{
  "exceptions": [
    {
      "action": "texto",
      "effect": "texto",
      "grantedAt": "2026-10-20T09:30:00-03:00",
      "grantedBy": "texto",
      "id": "3f0c2a5e-9b1d-4c7e-8a21-6d0f5b7ca91e",
      "moduleKey": "texto",
      "reason": "texto",
      "userId": "3f0c2a5e-9b1d-4c7e-8a21-6d0f5b7ca91e",
      "userName": "texto"
    }
  ],
  "modules": [
    {}
  ],
  "profiles": [
    {
      "baseRole": "texto",
      "builtIn": true,
      "description": "texto",
      "id": "3f0c2a5e-9b1d-4c7e-8a21-6d0f5b7ca91e",
      "label": "texto",
      "locked": true,
      "modules": {}
    }
  ]
}