⚡HTTP In

Construção da rota

Para definir uma rota de acesso ao Workspace Floui foram disponibilizadas algumas funcionalidades que auxiliam na construção da sua rota, permitindo que sejam parametrizados dados dinâmicos.

Parâmetros

Para definir parâmetros dinâmicos na rota utilize a notação :param. Quando for realizado a requisição para o Workspace Floui os dados do parâmetro poderão ser visualizados e acessados dinamicamente no fluxo.

No exemplo abaixo, foi definida a rota /product/:id, onde o valor de :id na requisição enviada ao Workspace é 12. Esse identificador e seu respectivo valor podem ser acessados e validados no fluxo utilizando a notação Mustache.

Neste caso, o caminho será {{msg.payload.params.id}}, onde params é o local onde todos os parâmetros da rota estarão armazenados.

Variáveis

Além dos parâmetros, também é possível usar variáveis locais do fluxo para criar rotas dinâmicas. Para isso, acesse as configurações do fluxo, clique em Variáveis e defina as chaves e valores desejados. Essas variáveis podem ser incorporadas à rota com a notação {{var nome_da_variável}}.

O preview exibido no conector mostrará automaticamente o valor correspondente à variável, desde que ela tenha sido previamente configurada.

É importante destacar que apenas variáveis locais do fluxo podem ser utilizadas na construção de rotas no conector. Variáveis globais definidas no Workspace não são suportadas. Isso garante que a configuração seja restrita ao contexto do fluxo.

Sucesso

Por padrão, o conector retornará um objeto JSON contendo alguns atributos comuns da requisição.

Descrição

• route: Indica a rota específica do URL solicitado.

• url: Representa o URL abstraído com referência ao workspace.

• baseUrl: É a parte da URL que corresponde à rota definida.

• originalUrl: Refere-se ao URL originalmente solicitado.

• path: É o caminho definido para a rota.

• method: Indica o método HTTP utilizado na solicitação, neste caso, é "GET".

• headers: Contém informações sobre os cabeçalhos da requisição HTTP, como o agente do usuário, tipos de conteúdo aceitos, idioma preferido, entre outros.

• body: Representa o corpo da requisição, que pode conter dados enviados pelo cliente.

• files: Uma lista indicando possíveis arquivos enviados junto com a requisição.

• query: Contém os parâmetros de consulta (query parameters) enviados na requisição.

• params: São os parâmetros da rota, se houver, definidos como parte da URL.

• protocol: Indica o protocolo utilizado, neste caso, HTTP.

• host: É o URL do engine (motor de processamento) onde a requisição foi recebida.

• ip: Representa o endereço IP da máquina local que originou a requisição.

Uso de conectores HTTP em fluxos

Quando um conector do tipo HTTP In é utilizado em um fluxo, é também esperado o uso de um conector do tipo HTTP Out. Este é responsável por gerenciar a saída da resposta da requisição recebida pelo HTTP In.

Autenticação

Em casos de erro na autenticação o fluxo não será executado e será informado um erro de autenticação nos registros de execução. Neste caso para a aplicação que tentou realizar a requisição terá um retorno 401 Unauthorized.

Em casos de sucesso o fluxo será executado com sucesso. Adicionalmente, os dados da autenticação Bearer e Basic poderão ser visualizados e acessados durante a execução do fluxo através do caminho {{msg.req.headers.authorization}}, disponibilizado uma camada a mais de segurança.

Retornos padrões