HTTP Out

Envie uma resposta personalizada em uma requisição realizada para o Workspace Floui.

O conector HTTP Out é geralmente utilizado em conjunto com conector HTTP In, servindo para finalizar e informar a execução do fluxo ao acessar uma rota dentro do Workspace Floui. Acesse a documentação do conector e saiba mais.

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.
HTTP Status	Campo de texto	O código de status HTTP é um valor padronizado que um servidor web devolve para indicar o status da sua requisição. Saiba mais em developer.mozilla.org.
Content-type header	Campo de texto	O cabeçalho HTTP Content-Type é usado para indicar o tipo de mídia do recurso. Em respostas HTTP, este cabeçalho informa ao cliente qual é o tipo de conteúdo retornado. Saiba mais em https://developer.mozilla.org
Additional Headers	Tabela de Parâmetros	Permite adicionar novos cabeçalhos em resposta HTTP
Header	Campo de texto	Nome do cabeçalho que será adicionado em resposta HTTP. Saiba mais em https://developer.mozilla.org
Value	Campo de texto	Valor do cabeçalho que será adicionado em resposta HTTP. Saiba mais em https://developer.mozilla.org
Enviar arquivo como resposta	Seletor	Permite selecionar se será enviado um arquivo junto à resposta, seja de forma dinâmica do fluxo ou pelo Storage interno, ou se será enviado uma resposta HTTP como um corpo (body).
Response body	Editor de código	Disponível caso optado por não enviar arquivo em configuração Enviar arquivo como resposta. Permite configurar uma resposta HTTP.
Caminho do arquivo no storage	Campo de texto	Disponível caso optado por enviar arquivo a partir do storage em configuração Enviar arquivo como resposta. Permite definir o caminho do arquivo, do Storage interno do Workspace, que será enviado junto à resposta.
Conteúdo do arquivo	Campo de texto	Disponível caso optado por enviar arquivo a partir do msg em configuração Enviar arquivo como resposta. Permite definir o caminho do arquivo, no objeto message, que será enviado junto à resposta.

Payload

Enviar response body

O conector HTTP Out pode retornar uma resposta HTTP padrão, que pode estar em formato de texto, JSON, XML, entre outros. Para enviar um response body, basta configurar o conector HTTP Out selecionando a opção Não na configuração Enviar arquivo como resposta. Isso habilita o campo Response Body, onde é possível definir a estrutura da resposta. Além disso, é possível utilizar a notação Mustache {{msg}} para inserir dados dinâmicos gerados durante a execução do fluxo na resposta.

Envio de arquivo com acesso em Storage interno

Para disponibilizar um arquivo armazenado no Storage do Workspace como resposta de uma requisição, adicione os conectores como o exemplo simples abaixo. Onde o conector HTTP In disponibiliza uma rota de acesso para o Workspace, e o conector HTTP Out irá retornar o arquivo do Storage.

Retorna arquivo armazenado em Storage.

No conector HTTP Out configure o Content-type header de acordo com a extensão do arquivo, neste caso será disponibilizado um PNG, logo será usado image/png. Em seguida, configure os cabeçalhos adicionais que deseja disponibilizar junto à resposta. Após isto, na configuração Enviar arquivo como resposta, selecione a opção Enviar a partir do Storage, e em seguida, no campo Caminho do arquivo no storage preencha o caminho do arquivo que deseja servir.

Ao acessar a rota definida no HTTP In o fluxo será iniciado e será retornado um arquivo como resposta.

Envio de arquivo a partir do objeto Message

Também é possível disponibilizar um arquivo através do contexto do fluxo pelo objeto message. O objeto message (msg) carrega todos os dados de execução do fluxo. Neste caso o objeto message pode conter um arquivo, durante a sua execução, que poderá ser servido através de uma resposta HTTP.

No exemplo, o conector HTTP In disponibiliza uma rota de acesso para o Workspace, enquanto o conector File Reader irá ler um arquivo, no caso uma imagem, e irá converter em um buffer ([object ArrayBuffer]) de forma temporária durante a execução do fluxo. O conector HTTP Out irá receber este objeto e servir em forma de arquivo.

No conector HTTP Out configure o Content-type header de acordo com o arquivo, neste caso será disponibilizado um PNG, logo será usado image/png. Em seguida, configure os cabeçalhos adicionais que deseja disponibilizar junto à resposta. Após isto, na configuração Enviar arquivo como resposta, selecione a opção Enviar a partir do Message, e em seguida, no campo Conteúdo do arquivo preencha o caminho deste objeto buffer.

Retorna arquivo de objeto message.