Aviso | ||
---|---|---|
| ||
O novo REST 2.0 não contempla ainda o retorno em chunked e possui por enquanto uma diferença na subida das threads do serviço. No Rest ADVPL, ao subir o appserver ele inicia o serviço com a quantidade de threads configuradas com inicial, através da chave instances. No REST 2.0, por enquanto, ele inicia o serviço sem nenhuma thread ativa, subindo a quantidade prevista como inicial somente após a primeira requisição. Estes comportamentos Este comportamento tem previsão de alteração para a lib e appservers a serem disponibilizados a partir de julho de 2021. |
Informações | ||
---|---|---|
| ||
O novo REST 2.0 contempla o retorno em chunked a partir da lib label 20201123 |
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 de novembro.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 31 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 chave chave ADVPL=1 0 na seção [HTTPV11] . A partir da lib label 20201123 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 31 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.0. 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.
...