A API do TOTVS Protheus oferece uma poderosa interface para integrar sistemas e automatizar processos. Explore as funcionalidades para maximizar o uso da sua infraestrutura Protheus. Para criar um serviço REST no Protheus, utilizamos a classe WSRESTFUL. Com ela, podemos publicar nosso serviço e declarar métodos GET, POST, PUT e DELETE.
Pré-requisitos
Manter os includes atualizados conforme o portal de download da TOTVS.
Configurar o Ini para o Rest Protheus
Passo a Passo
1. Declarar os Includes
Primeiro, declare os includes necessários:
#include “totvs.ch”
#include “restful.ch”
2. Criar a Classe WSRESTFUL
Em seguida, crie a classe WSRESTFUL, definindo um nome, uma descrição e encerrando com END WSRESTFUL.
WSRESTFUL helloworld DESCRIPTION “Meu Primeiro serviço REST!”
END WSRESTFUL
3. Declarar os Métodos
Declare os métodos que serão utilizados na sua classe. No exemplo, criaremos um método GET para retornar uma mensagem “Hello World”.
WSMETHOD GET DESCRIPTION “Retornar um Hello World”
4. Desenvolver o Método
Desenvolva o método, associando-o à classe com WSSERVICE. Use setResponse para definir a resposta da requisição e finalize com return .T..
WSMETHOD GET WSSERVICE helloworld
::setResponse(‘[{“Status”:”Hello World”}]’)
return .T.
Código Completo
Ao final, o código completo deve ficar assim:
#include “totvs.ch”
#include “restful.ch”
WSRESTFUL helloworld DESCRIPTION “Meu Primeiro serviço REST!”
WSMETHOD GET DESCRIPTION “Retornar um Hello World”
END WSRESTFUL
WSMETHOD GET WSSERVICE helloworld
::setResponse(‘[{“Status”:”Hello World”}]’)
return .T.
5. Compilar e Publicar
Após compilar o exemplo, para seja publicado na lista de APIs.