Histórico da Página
O web service REST do AdvPL não utiliza as seções HTTP e WebServices utilizadas para o configurar o modelo SOAP.
...
| Observação |
|---|
| O protocoloco HTTP do REST não atende a outros tipos de requisições como o HTTP do SOAP (que também atende arquivos estáticos, APW e APL) |
Seção HTTPV11
...
Para habilitar o HTTP para REST criar a seção abaixo no appserver.ini:
[HTTPV11]
Enable=1 ; (Obrigatório) indica se o HTTP está habilitado
Sockets=HTTPREST ; (Obrigatório) seções com configuração de porta e URL (pelo menos uma seção)
...
Sockets=HTTPREST
| Parametro | Descrição | Obrigatório |
|---|---|---|
| Enable | Indica se o HTTP esta habilitado | x |
| Sockets | Seções com configuração de porta e URL (pelo menos uma seção) | x |
A chave Sockets referencia a(s) seção(ões) com a configuração de porta e URL que a mesma ira atender, permitindo que o Application Server seja configurado com mais de uma porta HTTP do REST:
Sockets=HTTPREST,HTTPREST2
...
Seções Sockets
...
Exemplo de configuração de uma seção Sockets:
[HTTPREST]
Port=8080 ; (Obrigatório) porta HTTP
IPsBind= ; (Opcional) indica os IPs que serão atendidos por essa porta, se não informado atenderá qualquer IP / DNS associado ao servidor
URIs=HTTPURI ; (Obrigatório)
SECURITY=1 ; (Obrigatório) indica se a autenticação de requisição esta habilitada
IPsBind=
URIs=HTTPURI
Security=1
| Parametro | Descrição | Obrigatório |
|---|---|---|
| Port | Porta HTTP | x |
| IPsBind | Indica os IPs que serão atendidos por essa porta, se não informado atenderá qualquer IP / DNS associado ao servidor | |
| URIs | Seções com configuração de URL e ambiente (pelo menos uma seção) | x |
| Security | Indica se a autenticação de requisição esta habilitada | x |
| Observação |
|---|
| O HTTP do REST verifica existência do campo Authorization no HEADER da requisição (para OAUTH e BASIC), porém a autorização é realizada pelo framework do produto que esta utilizando o protocolo |
...
A chave URIs referencia a(s) seção(ões) com a configuração da URL que a porta irá atender, permite também que seja configurado com mais de uma URL:
URIs=HTTPURI,HTTPURI2
Seções URIs
...
Exemplo de configuração de uma seção URIs:
[HTTPURI]
URL=/rest ; (Obrigatório) indica o endereço que será atendido, nesse exemplo
PrepareIn=
Instances=1,1
| Parametro | Descrição | Obrigatório |
|---|---|---|
| URL | Indica o endereço que será atendido Nesse exemplo http://localhost:8080/rest |
...
| x | ||
| Preparein | Informações para preparação do ambiente das working threads | |
| Instances | Configuração de inicialização de working threads | x |
| Observaçoes |
|---|
| A preparação de ambiente da chave PrepareIn é realizada pelo framework do produto que esta utilizando o protocolo |
| A chave Instances é configurada como no HTTP do SOAP, confira a documentação em Instances |
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas