Pular para o conteúdo principal

Nó http in

O nó http in é usado para criar endpoints HTTP que podem processar solicitações HTTP de entrada (GET, POST, PUT e outros). Este nó é o ponto de entrada para interagir com sistemas externos através do protocolo HTTP.

Importante: Todos os caminhos especificados recebem automaticamente o prefixo: /api/admin/workflows/endpoints/.

Configurações do nó http in​

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

Exemplo:

  • Nome do nó: get payment link

2. Método​

Método HTTP que o nó irá processar. As seguintes opções estão disponíveis:

  • GET: Usado para obter dados.
  • POST: Usado para enviar dados.
  • PUT: Usado para atualizar dados.
  • DELETE: Usado para excluir dados.
  • PATCH: Usado para atualização parcial de dados.
  • OPTIONS: Usado para solicitações de obtenção de metainformações sobre a API.

Especifica o caminho (endpoint) para processar solicitações.

  • O caminho começa com /.
  • Pode incluir variáveis de rota, por exemplo: /data/:id.

Exemplo:

  • Link: /get-payment-link
  • Link com parâmetro: /get-payment-link/:orderId

Formato da mensagem de entrada​

Quando uma solicitação chega ao caminho especificado com o método escolhido, o nó http in cria uma mensagem msg com as seguintes propriedades:

  • msg.req: Contém o objeto da solicitação HTTP, incluindo cabeçalhos, parâmetros, corpo e outros dados.
    • msg.req.params: Parâmetros de rota (por exemplo, :id em /api/data/:id).
    • msg.req.query: Parâmetros GET da solicitação.
    • msg.req.body: Corpo da solicitação (para métodos POST, PUT e PATCH).
  • msg.res: Objeto para gerenciar a resposta HTTP. Normalmente é passado para o nó http response para enviar a resposta ao cliente.

Exemplo de uso​

Exemplo 1: Processamento de solicitação GET​

Cenário: Retorno de dados sobre temperatura.

Configurações do nó:

  • Método: GET
  • Link: /temperature

Fluxo:

[http in] ---> [function] ---> [http response]

Código do nó function:

msg.payload = { temperature: 22.5, unit: "Celsius" };
return msg;

Resultado: O cliente que enviar uma solicitação GET para /api/admin/workflows/endpoints/temperature receberá uma resposta JSON:

{
  "temperature": 22.5,
  "unit": "Celsius"
}

Exemplo 2: Processamento de solicitação POST​

Cenário: Recepção e armazenamento de dados de um dispositivo.

Configurações do nó:

  • Método: POST
  • Link: /data

Fluxo:

[http in] ---> [function] ---> [http response]

Código do nó function:

// Leitura de dados do corpo da solicitação
const data = msg.req.body;
msg.payload = { status: "success", receivedData: data };
return msg;

Resultado: O nó receberá os dados do corpo da solicitação POST e retornará uma resposta de confirmação.

Exemplo 3: Uso de parâmetros de rota​

Cenário: Obtenção de dados pelo identificador do dispositivo.

Configurações do nó:

  • Método: GET
  • Link: /device/:id

Fluxo:

[http in] ---> [function] ---> [http response]

Código do nó function:

const deviceId = msg.req.params.id;
msg.payload = { deviceId: deviceId, status: "active" };
return msg;

Resultado:

{
  "deviceId": "123",
  "status": "active"
}