# HTTP Request {% tabs %} {% tab title="Parâmetros" %}

| Campo | Tipo | Descrição | | -------------------------------------- | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Descrição | Campo de texto | Descrição visual do conector na construção do fluxo. | | URL | Campo de texto | Especifica a localização do recurso na web. É composta pelo esquema (por exemplo, "http" ou "https"), o domínio (como "[www.exemplo.com](http://www.exemplo.com)") e o caminho do recurso (como “/product/list”). | | Tipo do corpo da requisição | Seletor | Permite escolher como será enviado o corpo da requisição entre: JSON, Raw/Text ou Form Data. | | Request Body | Editor de código | Campo disponível quando selecionado o Tipo do corpo da requisição como JSON ou Raw/Text. Disponibiliza um editor de código para inserir o corpo da requisição. | | Form data | Tabela de parâmetros | Campo disponível quando selecionado o Tipo do corpo da requisição como Raw/Text. Disponibiliza uma tabela de parâmetros para definir os campos e valores do formulário. | | Use authentication | Seletor | Especifica o tipo de autenticação ao ser usada na requisição. Permite selecionar entre Bearer Token, Basic Auth ou Sem autenticação | | Bearer Token | Campo de texto | Campo disponível quando selecionada a autenticação Bearer Token. Permite definir o token que será usado autenticação. | | User 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. | | Tempo limite para execução em segundos | Campo de texto | Permite adicionar um tempo limite para controlar o tempo máximo em que a requisição irá consumir. | | Additional Headers | Tabela de parâmetros | Permite configurar informações adicionais na requisição para controlar o comportamento da solicitação, transmitir informações sobre o cliente, ou o tipo de conteúdo esperado. | | Response Type | Seletor | Permite selecionar como a resposta será disponibilizada, entre: JSON, Text, Binário (buffer) | | Output Path | Campo de texto | Refere-se ao caminho de saída do resultado da requisição gerado no contexto de execução do conector | | {% endtab %} | | | {% tab title="Payload" %} ## Sucesso Ao final da execução, serão retornados os dados da resposta da requisição realizada para a URL informada no conector, além de dados adicionais na mensagem contendo metadados da requisição e a resposta do servidor. Todos os dados exportados pelo Floui são armazenados no objeto msg. Por padrão, ao criar um novo componente, o atributo payload é criado para armazenar os dados gerados. Esse atributo pode ser renomeado para não sobrescrever cargas de dados anteriores ou até mesmo, serem sobrescritos.


payload { }	Objeto contendo o conteúdo oferecido pela API.
response { }	Contém detalhes da resposta, permitindo monitorar a integridade através do status ou mensagens de retorno.
request { }	Exibe detalhes da requisição como URL, método, parâmetros, entre outras informações.

## Erro Em situações de erro, além de um campo message com a descrição do motivo do erro, também serão disponibilizados dados adicionais relacionados à requisição.

Caso o tempo limite configurado no conector seja atingido durante o processamento, a execução será interrompida e retornará uma mensagem indicando que o limite de tempo foi excedido.

## Limite de tamanho do corpo da requisição No conector HTTP Request é definido um limite padrão de 10mb referente ao tamanho do corpo da requisição que poderá ser enviado. Caso o corpo da requisição tenha ou ultrapasse este limite irá disparar o seguinte erro durante a execução.

{% 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/conectores-essenciais/http-request.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.