Pular para o conteúdo principal

Nó http response

O nó http response é utilizado para enviar respostas HTTP para solicitações processadas pelo nó http in. Ele finaliza o ciclo de processamento da solicitação e transmite os dados de volta ao cliente.

Configurações do nó http response​

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

Exemplo:

  • Nome do nó: Enviar Resposta JSON

Campos definidos pela mensagem de entrada (msg)​

O nó http response utiliza o objeto msg que lhe é passado como entrada para formar a resposta HTTP. Aqui estão os principais parâmetros:

  1. msg.payload
    O conteúdo da resposta. Ele é enviado ao cliente no corpo da resposta.

    Exemplo:

    • Para enviar texto: 
      msg.payload = "Olá, Mundo!";
    • Para resposta JSON: 
      msg.payload = { status: "ok", value: 42 };

  1. msg.statusCode
    Código de status HTTP da resposta. Se este campo não for especificado, o padrão é 200 OK.

    Exemplos de códigos de status:

    • 200 — Sucesso.
    • 201 — Recurso criado com sucesso.
    • 400 — Erro do cliente.
    • 404 — Recurso não encontrado.
    • 500 — Erro interno do servidor.

    Exemplo:

    msg.statusCode = 404; // Recurso não encontrado

  1. msg.headers
    Objeto que define os cabeçalhos da resposta HTTP. Permite especificar, por exemplo, o tipo de conteúdo, cache ou cabeçalhos personalizados.

    Exemplo:

    msg.headers = {
        "Content-Type": "application/json",
        "Cache-Control": "no-cache"
    };

Exemplos de uso​

Exemplo 1: Enviando uma resposta JSON de sucesso​

Fluxo:

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

Código do nó function:

msg.payload = { success: true, message: "Solicitação processada com sucesso" };
msg.statusCode = 200;
msg.headers = { "Content-Type": "application/json" };
return msg;

Resultado:
O cliente receberá a resposta:

HTTP/1.1 200 OK
Content-Type: application/json

{
    "success": true,
    "message": "Solicitação processada com sucesso"
}

Exemplo 2: Tratamento de erro​

Fluxo:

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

Código do nó function:

msg.payload = { error: "Parâmetros de solicitação inválidos" };
msg.statusCode = 400;
msg.headers = { "Content-Type": "application/json" };
return msg;

Resultado:
O cliente receberá a resposta:

HTTP/1.1 400 Bad Request
Content-Type: application/json

{
    "error": "Parâmetros de solicitação inválidos"
}

Exemplo 3: Resposta vazia com status personalizado​

Fluxo:

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

Código no nó function antes do nó http response:

msg.payload = null; // Corpo da resposta vazio
msg.statusCode = 204; // Sem conteúdo
return msg;

Resultado:
O cliente receberá a resposta:

HTTP/1.1 204 No Content