O node HTTP Request conversa com qualquer serviço que tenha uma API, mesmo sem integração pronta no n8n. É o node que transforma "esse sistema não é suportado" em "esse sistema não tem documentação" — que é um problema bem menor. Se você aprender só ele deste módulo, já dobra o que consegue automatizar.
Adicione ao Google NotíciasNeste artigo
Os quatro campos que resolvem 90% dos casos
Método. O verbo da requisição. GET busca informação, POST cria, PUT e PATCH atualizam, DELETE apaga. Quando a documentação da API diz "faça um POST para tal endereço", é aqui.
URL. O endereço. Aceita expressão, então dá para montar dinamicamente: https://api.exemplo.com/clientes/{{ $json.id }}.
Autenticação. Como o serviço sabe que é você. Assunto da próxima aula, porque é onde mais gente trava.
Corpo. Os dados que você envia, em POST e PUT. Normalmente em formato JSON.
Lendo a documentação de uma API
Quase toda documentação segue o mesmo desenho, e saber traduzi-la para os campos do node é a habilidade que importa:
| Na documentação | No node |
|---|---|
POST /v1/contacts | Método POST, URL terminando em /v1/contacts |
| "Requires Bearer token" | Autenticação por cabeçalho, tipo Bearer |
"Query parameter: limit" | Enviar parâmetro de consulta chamado limit |
"Body: { "name": "..." }" | Corpo em JSON com o campo name |
| "Returns 201 on success" | Código 201 é sucesso, não erro |
Existe um atalho que economiza muito tempo: se a documentação da API traz um exemplo em curl, o n8n consegue importar esse comando e preencher o node inteiro sozinho — método, URL, cabeçalhos e corpo. Procure a opção de importar cURL antes de configurar na mão.
Onde vai cada coisa
Confusão frequente: um mesmo valor pode ir em três lugares diferentes, e só a documentação da API diz qual.
Parâmetro de consulta — vai na URL depois do
?. Usado para filtro e paginação:?status=ativo&limit=50.Cabeçalho — informação sobre a requisição: autenticação, formato aceito, identificação do cliente.
Corpo — o conteúdo em si. Só faz sentido em métodos que enviam dados.
Mandar no lugar errado costuma devolver erro de campo obrigatório ausente, mesmo com o campo preenchido — porque a API procurou onde ele não está.
Lendo o retorno
A resposta vira item, e você acessa com expressão como qualquer outro dado. Duas armadilhas:
A lista vem aninhada. Muitas APIs devolvem algo como { "data": [...], "total": 120 }. A lista está em data, não na raiz. Para o fluxo tratar cada registro individualmente, é preciso separar essa lista em itens — senão você tem um item só contendo 120 registros dentro.
Erro nem sempre é erro. Algumas APIs devolvem código 200 com uma mensagem de falha no corpo. O node considera sucesso. Se o seu fluxo "funciona" mas nada acontece do outro lado, leia o conteúdo da resposta antes de procurar o problema em outro lugar.
Os códigos que você precisa reconhecer
| Código | Significa | O que fazer |
|---|---|---|
| 200, 201, 204 | Deu certo | Nada |
| 400 | Requisição malformada | Revisar corpo e parâmetros |
| 401 | Não autenticado | Credencial errada ou vencida |
| 403 | Autenticado, sem permissão | A conta não tem acesso ao recurso |
| 404 | Não existe | URL errada ou registro removido |
| 429 | Requisições demais | Limite de uso — assunto de outra aula |
| 500, 502, 503 | Problema do outro lado | Tentar de novo depois |
A distinção entre 401 e 403 poupa horas: 401 é credencial; 403 é credencial certa sem permissão. São problemas diferentes com soluções diferentes.
Antes de montar o fluxo inteiro em cima de uma API nova, faça uma requisição só e veja o que volta. Descobrir na décima requisição que o formato não é o esperado custa muito mais caro que testar uma vez.
Método, URL, autenticação e corpo. Some a isso saber onde cada valor entra e o que cada código significa, e você conecta praticamente qualquer serviço.
Perguntas frequentes
Para que serve o node HTTP Request no n8n?
Para conversar com qualquer serviço que tenha API, inclusive os que não têm integração pronta no n8n. Ele monta a requisição — método, endereço, autenticação e dados — e devolve a resposta como item para o fluxo continuar.
Como usar uma API sem node pronto no n8n?
Com o HTTP Request, traduzindo a documentação da API para os campos do node. Se a documentação trouxer um exemplo em cURL, é possível importar o comando e ter o node preenchido automaticamente.
Qual a diferença entre parâmetro de consulta, cabeçalho e corpo?
O parâmetro de consulta vai na URL após o ponto de interrogação e serve para filtro e paginação. O cabeçalho carrega informação sobre a requisição, como autenticação. O corpo leva o conteúdo em si, e só existe em métodos que enviam dados, como POST e PUT.
O que significa erro 401 e 403?
401 indica falta de autenticação: a credencial está errada, ausente ou vencida. 403 indica que a autenticação funcionou, mas a conta não tem permissão para aquele recurso. São problemas diferentes — o primeiro se resolve na credencial, o segundo nas permissões da conta.
Por que a resposta veio como um item só com muitos registros?
Porque a API devolveu a lista aninhada dentro de um campo, e o n8n recebeu tudo como um único item. Para o fluxo processar cada registro individualmente, é preciso separar essa lista em itens antes de seguir.
