Inicia a declaração de uma classe REST (Server) de Web Services em AdvPL.
Abrangência
ERP 11 e superiores
...
Painel |
---|
WSRESTFUL [ cServiceName] [ Description ] |
|
WSRESTFUL <cServiceName> DESCRIPTION <cDescription> [SECURITY <cSecurity>] [FORMAT <cFormat>] [SSL ONLY] |
Nome | Tipo | Descrição | Obrigatório | Referência |
cServiceName | Caracter | Indica 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 |
| Description Indica da classe apresentada na janela de índicedo serviço. Essa informação é |
fornecida também, junto do WSDL gerado pelo TOTVS Application Server para o serviço especificado.X | | utilizada na listagem dos serviços REST disponíveis no TOTVS| Application Server e serve como documentação do serviço. | X |
|
cSecurity | Caracter | Informe o nome da rotina que tem relação com a API REST (exemplo MATA030 ou MATA410), esse nome será utilizado para validação dos privilégios, permitindo assim o acesso ou não a API. |
|
|
cFormat | Caracter | Informe o formato de exportação do serviço. Esta informação é utilizada na listagem dos serviços REST. |
|
|
SSL ONLY | - | Indica que a classe só permitirá o acesso via conexão segura do tipo SSL (Secure Socket Layer). |
|
|
- Dentro da estrutura de um classe (Server) de REST, deve-se declarar os métodos disponibilizados da classe, propriedades, parâmetros e retornos utilizados. Para isso, utilize os comandos WSMETHOD e WSDATA.
- Para encerrar a declaração da classe, utilize o comando END WSRESTFUL
- Para utilizar este comando, é necessário declarar a #INCLUDE RESTFUL.CH no código-fonte AdvPL.
Bloco de código |
---|
title | Exemplo |
---|
firstline | 1 |
---|
linenumbers | true |
---|
|
#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"
WSMETHOD POST DESCRIPTION "POST"
WSMETHOD PUT DESCRIPTION "PUT"
WSMETHOD DELETE DESCRIPTION "DELETE"
END WSRESTFUL