Pular para o conteúdo principal

Nó http request

O nó http request é projetado para executar solicitações HTTP a serviços web externos ou APIs. Ele suporta vários métodos HTTP, formas de transmissão de dados, autenticação e gerenciamento flexível de solicitações e respostas.

Configurações do nó http request​

IMG2

1. Nome​

Campo para especificar o nome do nó.
O nome é exibido na área de trabalho e ajuda a identificar facilmente o nó.
Se deixado em branco, o nó será chamado de http request.

Exemplo:

  • Nome do nó: Obter Dados do Clima

2. Método​

Método HTTP que será utilizado para a solicitação. A escolha do método depende do tipo de operação que precisa ser realizada.

Métodos disponíveis:

  • GET: Obter dados.
  • POST: Enviar dados.
  • PUT: Atualizar dados.
  • DELETE: Remover dados.
  • HEAD: Obter cabeçalhos da resposta.

Exemplo:

  • Método: POST

Campo para especificar um URL estático para o qual a solicitação será enviada.
Se o endereço precisar ser definido dinamicamente, ele pode ser passado em msg.url.

Exemplo:

  • Link: https://api.example.com/data

4. Dados​

Define como os dados de entrada serão adicionados à solicitação HTTP. As seguintes opções estão disponíveis:

  1. Ignorar (padrão):
    Os dados de entrada não serão utilizados na solicitação. O campo msg.payload, se existir, será ignorado.

    Exemplo:
    Se msg.payload contiver um objeto JSON, ele não será incluído na solicitação.

  1. Adicionar aos parâmetros de consulta:
    Os dados de msg.payload serão convertidos em parâmetros de string de consulta (Query Parameters) e adicionados ao URL.

    Exemplo:
    Se msg.payload contiver:

    {
      "key1": "value1",
      "key2": "value2"
    }

    Se o Link for especificado como http://example.com/api, a solicitação final será:
    GET http://example.com/api?key1=value1&key2=value2.

  1. Enviar como corpo da solicitação:
    Os dados de msg.payload serão enviados no corpo da solicitação. Esta opção é adequada para métodos POST e PUT, onde os dados são frequentemente transmitidos no corpo.

    Exemplo:
    Se msg.payload contiver:

    {
      "name": "John Doe",
      "email": "john.doe@example.com"
    }

    Se o método da solicitação for POST, os dados serão enviados no corpo da solicitação com o conteúdo apropriado.

5. Retornar​

Define em qual formato o nó processará a resposta do servidor.

Opções:

  • String: A resposta é convertida em string (padrão).
  • Objeto JSON: Se a resposta do servidor estiver no formato JSON, ela será automaticamente convertida em um objeto JavaScript.
  • Buffer Binário: A resposta é retornada como um buffer binário (útil para dados binários, como imagens ou arquivos).

Exemplo:

  • Se Objeto JSON for selecionado, a resposta: 
    {"status": "ok", "value": 42}
    É convertida em: 
    msg.payload = { status: "ok", value: 42 };

6. Usar Autenticação​

A caixa de seleção ativa a autenticação embutida (desativada por padrão). Quando ativada, um campo Tipo aparece no formulário com o método de autenticação (padrão basic):

basic​

  • Nome de usuário: Nome de usuário.
  • Senha: Senha.

bearer​

  • Senha: Token de acesso.

digest​

  • Nome de usuário: Nome de usuário.
  • Senha: Senha.

Dados de Entrada​

O nó http request aceita um objeto de mensagem msg com os parâmetros:

  1. msg.url: URL para a solicitação (se não especificado nas configurações do nó).
  2. msg.method: Método HTTP (se não definido nas configurações do nó).
  3. msg.payload: Corpo da solicitação (usado para métodos POST, PUT).
  4. msg.headers: Cabeçalhos da solicitação HTTP (objeto).

Dados de Saída​

O nó retorna um objeto msg com informações sobre a solicitação realizada:

  1. msg.payload: Dados da resposta do servidor.
  2. msg.statusCode: Código de status HTTP da resposta (por exemplo, 200 ou 404).
  3. msg.headers: Cabeçalhos da resposta.
  4. msg.responseUrl: URL para o qual a solicitação foi feita.
  5. msg.error: Descrição do erro (se a solicitação falhar).

Exemplos de Uso​

Exemplo 1: Executando uma solicitação GET​

Configurações do nó:

  • Método: GET
  • Link: https://api.weatherapi.com/v1/current.json?key=API_KEY&q=London

Fluxo:

[inject] ---> [http request] ---> [debug]

Resultado: O nó retornará um JSON com o clima atual.

Exemplo 2: Enviando dados via POST​

Configurações do nó:

  • Método: POST
  • Link: https://api.example.com/devices
  • Dados: Enviar como corpo da solicitação

Fluxo:

[function] ---> [http request] ---> [debug]

Código no nó function:

msg.payload = {
    deviceId: "sensor123",
    status: "active"
};
msg.headers = { "Content-Type": "application/json" };
return msg;

Resultado: Os dados serão enviados e o nó retornará a resposta do servidor.

Exemplo 3: URL Dinâmico e Autenticação​

Configurações do nó:

  • Link: (deixar em branco)

Fluxo:

[function] ---> [http request] ---> [debug]

Código no nó function:

msg.url = "https://api.example.com/user/123";
msg.headers = { Authorization: "Bearer YOUR_TOKEN" };
return msg;

Resultado: O nó fará a solicitação para o URL especificado com o token de autenticação.