Histórico da Página

...

Vamos imaginar que você desenvolvedor precisa precise criar uma funcionalidade que busque uma lista de produtos do seu backend através do endereço  

...

Dessa forma o resultado do endereço para o request é "https://dev-mingle.totvs.com.br/listaProdutos" e através do seu ALIAS o Mingle identifica qual é o endereço final do servidor para realizar a chamada GET no endpoiont endpoint listaProdutos. 

Ao utilizar a classe mingleService.gateway você substitui o request http padrão do typescript e garante a segurança da informação.

O Mingle aceita apenas requisições com conteúdo JSON, objeto ou formData no body.

Headers customizados

É possível enviar headers customizados de acordo com a sua implementação para o seu host.

...

getProducts() {
   const options = {headers: {"x-totvs-header-customizado": "123456"}};
 
return this.mingleService.gateway.get('listaProdutos', options).subscribe(response=>{
     return JSON.stringify(response);
   }, error => {
     console.error("Error in gateway endpoint 'listaProdutos'");
     return error ;
   })
}

Classe mingleService.Gateway

A classe mingleService.gateway está pronta para realizar as seguintes ações:

Image Removed

Envio de arquivos

Query Params customizados

É possível enviar queryParams customizados de acordo com a sua implementação Se o seu aplicativo solicita arquivos para o usuário, você pode enviá-los para o seu host através do Mingle usando a interface FormData.

Essa interface utiliza o mesmo formato que um form html utilizaria se o tipo de codificação estivesse configurado como "multipart/form-data".

.

Neste exemplo, vamos adicionar o queryParams "filial e id" ao request, conforme exemplo abaixo:Neste exemplo, recebemos arquivos com qualquer tipo de extensões através do upload no html e enviamos com o MingleService no método sendFilesByMingle(fileUpload)

getProducts() {
   const queryParams = { "filial": "D MG", "id": "FIN501" }; 

return this.mingleService.gateway.get('listaProdutos', {}, queryParams).subscribe(response=>{
     return JSON.stringify(response);
   }, error => {
     console.error("Error in gateway endpoint 'listaProdutos'");
     return error ;
   })
}

Classe mingleService.Gateway

A classe mingleService.gateway está pronta para realizar as seguintes ações:

Image Added

Os métodos get, post,put, delete e patch são responsáveis pela comunicação http entre o aplicativo e o servidor do Mingle conforme apresentado nos tópicos anteriores desse documento. 

O método getHeaders retorna os headers padrões do MingleService.

O método getUrl retorna a URL padrão do MingleService. 

Envio de arquivos

Para saber mais sobre envio de arquivos com o gateway do Mingle, acesse: Transferência de arquivos