Histórico da Página
...
Sintaxe
| Informações | ||
|---|---|---|
| ||
| WSRESTFUL [ cServiceName] Description [ cDescription ] SECURITY [cSecurity] FORMAT [cFormat ]WSRESTFUL <cServiceName> DESCRIPTION <cDescription> [SECURITY <cSecurity>] [FORMAT <cFormat>] [SSL ONLY] |
Parâmetros
| 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 |
| cDescription | Caracter | Informe 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 |
| cSecurity | Caracter | Informe o nome da rotina que tem relação com a API REST (exemplo MATA030 ou MATA410) 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. | ||
| 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). |
Observações
- 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. .
- No parâmetro nomeado como FORMAT, apenas para o modo sem o uso de SSL, também é aceita a constante CONSUMES, mas seu efeito é o mesmo de utilizar FORMAT.
Para o conteúdo do parâmetro FORMAT estão definidas as seguintes constantes:
APPLICATION_ATOM_XML
APPLICATION_ATOM_XML_TYPE
APPLICATION_FORM_URLENCODED
APPLICATION_FORM_URLENCODED_TYPE
APPLICATION_JSON
APPLICATION_JSON_TYPE
APPLICATION_OCTET_STREAM
APPLICATION_OCTET_STREAM_TYPE
APPLICATION_SVG_XML
APPLICATION_SVG_XML_TYPE
APPLICATION_XHTML_XML
APPLICATION_XHTML_XML_TYPE
APPLICATION_XML
APPLICATION_XML_TYPE
MEDIA_TYPE_WILDCARD
MULTIPART_FORM_DATA
MULTIPART_FORM_DATA_TYPE
TEXT_HTML
TEXT_HTML_TYPE
TEXT_PLAIN
TEXT_PLAIN_TYPE
TEXT_XML
TEXT_XML_TYPE
WILDCARD
WILDCARD_TYPE
APPLICATION_XJAVASCRIPT
APPLICATION_JAVASCRIPT
TEXT_JAVASCRIPT
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas