ÍNDICE
- Visão Geral
- Exemplo de utilização
01. VISÃO GERAL
Abaixo você verá um exemplo de configuração do REST no arquivo appserver.ini para utilização dos aplicativos móveis.
Para informações mais detalhadas sobre o REST do Protheus, consulte a documentação complementar:
REST com ERP Microsiga Protheus
02. EXEMPLO DE UTILIZAÇÃO
Habilitar o servidor HTTP do Protheus, na versão 1.1, utilizando a seção HTTPV11.
Nesta seção, será indicado também qual seção será responsável por identificar os sockets que irão responder as requisições de entrada.
O segundo passo é criar a seção indicada HTTPREST, nela será inserida a porta onde o REST estará rodando (no exemplo: 8084), quais URIs serão atendidas e se a segurança estará habilitada ou não (para uso com os aplicativos móveis, é obrigatório que esteja habilitado).
Criar a seções com as URIs (observar o nome colocado no passo anterior.
- URL: Informar a URL em que os serviços serão expostos.
- PrepareIn: Qual empresa e filial será utilizada (note que isto impacta diretamente no consumo de licenças do REST).
- Instances: Quantas instâncias de serviço serão configuradas (note que isto impacta diretamente no consumo de licenças do REST).
- CORSEnable: Habilitar as requisições de cross-origens compartilhadas (obrigatório para o uso com mobile)
- AllowOrigin: As origens aceitas no CORS. (* = todas)
Configurar o appserver para iniciar um job chamado HTTPJOB quando for iniciado.
Configurar o JOB para que ele inicie o HTTPServer.
Abaixo um exemplo de todas as seções configuradas:
[HTTPV11]
Enable=1
Sockets=HTTPREST
[HTTPREST]
Port=8084
URIs=URIHTML
SECURITY=1
[URIHTML]
URL=/rest
PrepareIn=All
Instances=2,2
CORSEnable=1
AllowOrigin=*
[ONSTART]
jobs=HTTPJOB
RefreshRate=30
[HTTPJOB]
MAIN=HTTP_START
ENVIRONMENT=environment
Após executar todas as configurações, ao iniciar o appserver em modo console, deve ser possível visualizar a marcação do REST: