Inicia a declaração de uma classe REST (Server) em AdvPL.

Abrangência

ERP 11 e superiores

Sintaxe

WSRESTFUL [ cServiceName]  Description [ cDescription ] SECURITY [cSecurity] FORMAT [cFormat ]

Parâmetros

NomeTipoDescriçãoObrigatórioReferência
cServiceNameCaracterIndica o nome da classe REST que será declarada. O nome de uma classe REST, deve ser iniciada por um caractere alfabético e deve conter apenas os caracteres alfabéticos compreendidos entre A e Z, os caracteres numéricos compreendidos entre 0 e 9, podendo também ser utilizado o caracter "_" (underline). Um serviço não pode ter o nome de uma palavra reservada, da linguagem AdvPL, ou ter o nome igual a um tipo básico de informação.

O nome da classe REST é o mesmo utilizado na URI, desta forma, deve-se respeitar a estrutura de nomes permitidos na mesma.

X 
cDescription CaracterInforme a descrição do serviço. Essa informação é utilizada na listagem dos serviços REST disponíveis no TOTVS| Application Server e serve como documentação do serviço.X 
cFormatCaracterInforme o formato de exportação do serviço. Esta informação é utilizada na listagem dos serviços REST.  
cSecurityCaracterInforme o nome da rotina que tem relação com a API REST e deve ser usado no controle de segurança. O Framework REST irá verificar se o usuário autenticado possui acesso a rotina especificada. Caso não seja informado, somente o usuário Admin poderá acessar as APIs.  

 

Observações

Exemplo

#INCLUDE "TOTVS.CH"
#INCLUDE "RESTFUL.CH"
 
WSRESTFUL Users DESCRIPTION "Classe Users"
 
WSDATA cResponse   AS STRING
WSDATA Count      AS INTEGER OPTIONAL
WSDATA StartIndex AS INTEGER OPTIONAL 
 
 
WSMETHOD GET DESCRIPTION "GET" WSSYNTAX "/Users/{Id} "
WSMETHOD POST DESCRIPTION "POST" WSSYNTAX "/Users/{Id} "
WSMETHOD PUT DESCRIPTION "PUT" WSSYNTAX "/Users/{Id} "
WSMETHOD DELETE DESCRIPTION "DELETE" WSSYNTAX "/Users/{Id} "
 
 
END WSRESTFUL