Exibir origem

Descrição:

API para verificação de acessos (privilégios) a rotinas e alias do Protheus

É obrigatório o envio de autenticação nessa API, pois a verificação de acesso é feita com base no usuário logado

aliasAccess

Descrição:
Verifica se o usuário pode visualizar o alias informado

PathParam

Nome	Tipo	Descrição	Obrigatório	Valor padrão
Access	Character	Indica o nome do alias que será verificado o acesso	X

api/framework/v1/accessPrivilegesServices/aliasAccess/[Access]

{
	"access":true,
	"message":""
}

aliasAccess / nOpc

Descrição:
Verifica se o usuário pode efetuar alguma ação no alias informado, conforme a opção também informada

PathParam

Nome	Tipo	Descrição	Obrigatório	Valor padrão
Access	Character	Indica o nome do alias que será verificado o acesso	X
Opc	Integer	Indica o valor de nOpc que será verificado o acesso ao alias	X

api/framework/v1/accessPrivilegesServices/aliasAccess/[Access]/[Opc]

{
	"access":true,
	"message":""
}

functionAccess

Descrição:
Verifica se o usuário pode visualizar a rotina informada

PathParam

Nome	Tipo	Descrição	Obrigatório	Valor padrão
Access	Character	Indica o nome da rotina que será verificado o acesso	X

api/framework/v1/accessPrivilegesServices/functionAccess/[Access]

{
	"access":true,
	"message":""
}

functionAccess / nOpc

Descrição:
Verifica se o usuário pode efetuar alguma ação na rotina informada, conforme a opção também informada

PathParam

Nome	Tipo	Descrição	Obrigatório	Valor padrão
Access	Character	Indica o nome da rotina que será verificado o acesso	X
Opc	Integer	Indica o valor de nOpc que será verificado o acesso a rotina	X

api/framework/v1/accessPrivilegesServices/functionAccess/[Access]/[Opc]

{
	"access":true,
	"message":""
}

functionAccess / nOpc ? funname & operation (Submenu)

Descrição:
Verifica se o usuário pode efetuar alguma ação na rotina informada, conforme a opção informada dentro de um submenu

Parâmetros

Nome	Tipo	Descrição	Obrigatório	Local
Access	Character	Indica o nome da rotina que será verificado o acesso	X	PathParam
Opc	Integer	Indica o valor de nOpc que será verificado o acesso a rotina	X	PathParam
funname	Character	Indica o nome da sub-rotina que será verificado o acesso	X	Query Params
operation	Integer	Indica o número da Operação	X	Query Params

api/framework/v1/accessPrivilegesServices/functionAccess/[Access]/[Opc]?[funname]&[operation]

Exemplo de utilização dentro da rotina FINA740:

api/framework/v1/accessPrivilegesServices/functionAccess/FINA740/16?funname=FINA010(,3,.T.)&operation=4

Frameworksp > AccessPrivilegesServices > image-2025-11-7_14-32-58.png

{
	"access":true,
	"message":""
}

A rotina informada não é validada quanto a sua existência ou não, porém o alias informado possui uma validação de existência junto a SX2.

O retorno da API é padrão para todas as rotas, o valor message pode ou não vir preenchido conforma exista uma negação de acesso.

Essa API faz uso da função MPUserHasAccess para verificação de acessos.

<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>