Tempo aproximado para leitura: 00:03:00 min
Dúvida
Qual a configuração básica para subir o serviço REST no PROTHEUS ?
Ambiente
Cross Segmento - TOTVS BackOffice (Linha Protheus) – ADVPL – A partir da versão 12
Solução
Para configurar o serviço REST em nosso ambiente, precisamos das seguintes chaves(ini):
- HTTPJOB
Rotina que inicializa o servidor REST;
Configura qual ambiente do Protheus será acessado. - HTTPREST
Configura um socket que o servidor utilizará para comunicação;
Possibilita agrupar URI para atender diferentes ambientes;
Configura se o Rest Server solicitará autenticação de usuários. - HTTPV11
Habilita o uso do Rest server;
Agrupa a configuração dos Sockets de comunicação. - HTTPURI
Controla URL base onde os serviços serão disponibilizados;
Possui Informações para preparação do ambiente das working threads;
Controla quantidade de threads que ficarão disponíveis para responder às requisições.
[GENERAL] MAXSTRINGSIZE=10 [HTTPV11] Enable=1 Sockets=HTTPREST [HTTPREST] Port=8080 URIs=HTTPURI SECURITY=1 [HTTPURI] URL=/rest PrepareIn=All Instances=1,2 [ONSTART] jobs=HTTPJOB RefreshRate=30 [HTTPJOB] MAIN=HTTP_START ENVIRONMENT=environment
Se tudo estiver configurado corretamente, ira apresentar no console conforme abaixo:
Ao acessar o navegador com o endereço http://localhost:8080/rest , deverá ser exibida uma lista de API’s disponíveis.
Definição da URL
http://{IP do servidor}:(port}/{path}
Essa pagina mostra a lista de classes WSRESTFUL compiladas no RPO do ambiente configurado. Ao clicar nos detalhes de cada classe são exibidos os métodos disponíveis.
Importante:
O web service REST do AdvPL não utiliza as seções HTTP e WebServices utilizadas para o configurar o modelo SOAP.
Apesar disso o REST também utiliza working threads para atender as requisições recebidas também pelo protocolo HTTP.
O protocoloco HTTP do REST não atende a outros tipos de requisições como o HTTP do SOAP (que também atende arquivos estáticos, APW e APL).
Saiba mais
Configuração Web Services REST/Server
0 Comentários