Histórico da Página
...
| Informações | ||
|---|---|---|
| ||
O REST pode responder a requisição no idioma desejado, para isso é necessário enviar o header Accept-Language, sendo que somente são aceitos os idiomas que o Protheus suporta, como pt-BR, es e en. Com isso, a resposta passa a retornar o header Content-Language. Esse recurso está disponível a partir da lib 20210628, sendo que o REST ADVPL e o REST 2.0 tem suporte a esse header. |
| Informações | ||
|---|---|---|
| ||
A partir da lib 20211116 o REST passará a receber o header x-erp-module, que representa o módulo do Protheus, esse header suporta os valores de módulos do Protheus válidos, como: FIN, EST, FAT, ATF. |
| Informações | ||
|---|---|---|
| ||
A partir da lib 20240115 o REST passará a receber o header x-erp-database, que representa a databas do Protheus, esse header precisa ser enviado no formato AAAAMMDD |
Trabalhando na evolução tecnológica dos sistemas da Totvs, o REST Server do Protheus vem passando por algumas modernizações e isso vem sendo realizado através da parceria entre os times da Tecnologia e do Framework.
...
| Aviso | |||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||
O REST 2.0, que será disponibilizado a partir da Lib 20201009, irá utilizar a mesma configuração de ini do [HTTPV11] e irá substituir a versão antiga de forma automática a partir da Release 33 do Protheus (o REST convencional em ADVPL será descontinuado neste release). Para utilizar este recurso na lib 20201009 será necessário ligar a chave ADVPL=0 na seção [HTTPV11] . A partir da lib label 20210809 o REST 2.0 passará a ser utilizado por default no sistema, quando o AppServer tiver na versão igual ou superior a 19.3.1.8, mas poderá ser desligado através da mesma chave. Esta chave é temporária e a partir da release 33 do Protheus a mesma será descontinuada, sendo possível somente a configuração do novo REST 2.0. Além do pacote de lib acima é necessário também o uso do AppServer com versão igual ou superior a 19.3.1.80. Exemplo:
| |||||||||||||||||||
...
| Requisição | Resposta do REST ADVPL | Resposta do RestServer 2.0 | Encode retornado na resposta (REST ADVPL e REST 2.0) |
|---|---|---|---|
| Accept: charset=utf8 | Content-Type: charset=utf8 | Content-Type: charset=utf-8 | A própria lib realiza o encode para utf-8 |
| Accept: charset=utf-8 | Content-Type: charset=utf-8 | Content-Type: charset=utf-8 | A própria lib realiza o encode para utf-8 |
| Accept: charset=cp1252 | Content-Type: charset=cp1252 | Content-Type: charset=cp1252 | Não é realizado encode (irá utilizar o padrão do sistema) |
| Accept: charset=cp1251 | Content-Type: charset=cp1251 | Content-Type: charset=cp1251 | Não é realizado encode (irá utilizar o padrão do sistema) |
| Vazio | Vazio | Content-Type: charset=utf-8 | Não é realizado encode na camada de lib. |
| Accept: charset=QualquerOutroValor | Content-Type: charset=QualquerOutroValor | Content-Type: charset=utf-8 | Não é realizado encode na camada de lib. |
| Aviso | ||
|---|---|---|
| ||
Para o correto tratamento de encode nas apis, sugerimos o uso da função FWhttpEncode |
Com a substituição das camadas de accept e de controle já foi possível notar uma performance de resposta de requisição até 3x mais rápida com relação ao modelo ADVPL. Porém é importante ressaltar que o tempo de resposta depende muito do tipo de processamento que cada API realiza e que o ganho automático de performance se refere apenas ao tempo de pré-processamento da requisição. Com a substituição gradativa das API’s para o TLPP poderemos ter as respostas ainda mais performáticas, dependendo apenas da boa utilização da linguagem e da arquitetura adotada em cada API.
...
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas