Este artigo, mostra como ativar os serviços REST no ERP TOTVS Protheus na versão 12.1.2410. Se você precisa integrar APIs REST ao seu Protheus para conectar e‑commerce, apps móveis ou ferramentas de BI, aqui está a configuração mais simples para começar.

Visão geral do que vamos configurar

• Duplicar o App Server para ter uma instância dedicada aos serviços REST;
• Editar o arquivo appserver.ini e incluir as chaves necessárias (httpjob, httpv11, httpuris, instances, onstart etc.);
• Criar atalho do appserver.exe com parâmetro -console e iniciar os serviços;
• Testar pelo navegador em localhost:8080/rest e autenticar para ver as APIs disponíveis.

Passo a passo

1. Localize e duplique o App Server

Na pasta onde o Protheus está instalado, localize o App Server. Faça uma cópia dessa pasta para criar uma instância dedicada aos serviços REST — assim você evita consumir licenças do ambiente principal quando não for necessário.

2. Edite o appserver.ini e adicione as chaves essenciais

No arquivo appserver.ini da cópia criada, insira os trechos indicados pela documentação. As principais chaves e o objetivo de cada uma:

• httpjob — rotina que inicializa o servidor e define qual ambiente Protheus será acessado;
• http — configura sockets e possibilita agrupar URIs para diferentes ambientes;
• httpv11 — habilita o Rest Server e agrupa configurações de comunicação (porta, pasta base, segurança);
• httpuri (ou uri) — controla a URL base onde os serviços estarão disponíveis e define o número de threads/instâncias;
• onstart — determina jobs que serão chamados na inicialização;
• instances — quantidade de threads (execuções) para responder requisições — em base de teste normalmente se usa 2 devido a licenças.

Importante: a partir da versão 12.4.2410 é obrigatório usar a chave de autenticação (Security). Quando ativado, o servidor solicitará usuário e senha para acessar os serviços REST.

3. Criar atalho e ajustar propriedades

Crie um atalho do appserver.exe (clicar com botão direito → mostrar mais opções → criar atalho). Nas propriedades do atalho, adicione o parâmetro -console (ou ajuste conforme necessário) e mova o atalho para a pasta onde estão os demais serviços do Protheus. Renomeie o atalho para algo identificável, por exemplo, appserver-rest.

4. Inicie os serviços e verifique

Suba primeiro o DBAccess e depois a instância do App Server criada. No console você verá mensagens indicando que o httpv11 foi ativado, porta 8080 (ou a porta configurada) e a pasta base (por exemplo: /rest).

5. Acesse pelo navegador

Abra o navegador e acesse: http://localhost:8080/rest (ajuste porta/pasta conforme sua configuração). Você verá a tela de login. Utilize um usuário com permissão de administrador (ex.: admin) e a senha definida. Após o login, a documentação das APIs disponíveis será exibida — por exemplo, Company → details para consultar empresas da base de teste.

Dicas Extras

• Em produção, configure autenticação (Security) e certificados SSL para garantir segurança na comunicação;
• Ajuste a quantidade de instâncias/threads de acordo com as licenças e a demanda do ambiente;
• Documente os endpoints que sua empresa vai expor e controle permissões por usuário;
• Se precisar, conte com consultoria da RFB Sistemas para customizações avançadas e integração com outros sistemas, clique aqui e entre em contato com a nossa equipe.

Considerações Finais

Esta aula foi uma breve explicação de como ativar os serviços REST no TOTVS Protheus, para conferir o processo completo de forma prática sugerimos que assista o vídeo no início da página.

Cursos

Se você está buscando se tornar um desenvolvedor completo no Protheus, dominar REST, PO-UI e as demais tecnologias relacionadas ao Protheus, não fique de fora da nossa turma de alunos, clique aqui para mais detalhes.