# HTTP In ### 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.

{% hint style="info" %} 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. {% endhint %}

{% tabs %} {% tab title="Parâmetros" %}

| 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 | | {% endtab %} | | | {% tab title="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.

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

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. {% endtab %} {% tab title="Payload" %} ## 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.

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.

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

Status	Detalhes
200	Retorno padrão destinado a requisição de entrada.
429	Indica que o número de execuções foi atingida

{% endtab %} {% endtabs %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.floui.io/guia/conectores/categorias/triggers/http-in.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.