⚡HTTP In

Disponibiliza uma determinada rota servindo como gatilho para a execução do fluxo.

Workspace URL

O conector HTTP In permite definir uma rota para a URL padrão do seu Workspace. Para consultar a URL única do seu Workspace, acesse a aba de Workspaces no Painel da Conta e copie a URL do Workspace que deseja referenciar.

Copiando a URL do seu Workspace

Com o conector HTTP In, é possível criar rotas no seu Workspace acessíveis a outros sistemas através de métodos HTTP, tanto com autenticação quanto sem. Isso possibilita o desenvolvimento de uma ampla gama de soluções, incluindo APIs e proxies para outros serviços.

Estrutura de uma URL de Workspace.

Parâmetros

Parâmetros de configuração

Campo	Tipo	Descrição
Descrição	Campo de texto	Descrição visual do conector na construção do fluxo.
Route	Campo de texto	Rota que será aberta no Workspace Floui para acesso externo. O botão ao lado permite copiar toda a rota construída para a área de transferência.
Método HTTP	Seletor	Método HTTP da rota aberta no Workspace Floui.
Use authentication	Seletor	Especifica se haverá autenticação ao realizar requisição para o Workspace Floui. Permite selecionar entre Bearer Token, Basic Auth ou Sem autenticação
Token	Campo de texto	Campo disponível quando selecionada a autenticação Bearer Token. Permite definir o token que será usado autenticação.
Username e password	Campos de texto	Campos disponíveis quando selecionada a autenticação Basic Auth. Permite definir o usuário e senha que deverá ser usado para realizar autenticação.
Output Path	Campo de texto	Refere-se ao caminho dos dados da requisição para o Workspace no contexto de execução do fluxo

Construção de rota

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.

Parâmetros em rota

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}}.

Configuração de variáveis do fluxo

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

Configuração de variável de fluxo em construção de rota

É 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.

Payload

Sucesso

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

Sucesso ao acessar endpoint

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.

Fluxo informa o uso de conector HTTP Out para gerenciar saída de requisição

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.

Erro em autenticação

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.

Dados de autenticação

Retornos padrões

200

Retorno padrão destinado a requisição de entrada.

429

Indica que o número de execuções foi atingida