Consuma uma API com o HTTP Request

O node HTTP Request chama qualquer serviço que tenha uma API REST. Use quando não existe um node pronto para o serviço ou quando o node pronto não oferece o endpoint necessário.

Comece pelo curl da documentação

Muitas APIs mostram exemplos em curl. O node permite importar esse comando: selecione Import cURL e cole o exemplo. O n8n preenche método, URL, cabeçalhos e corpo. Revise cada campo antes de executar.

Configure à mão

Campo	O que preencher
Method	GET para consultar, POST para criar, PUT ou PATCH para alterar, DELETE para apagar
URL	O endereço do endpoint
Authentication	Predefined Credential Type quando o serviço tem credencial no n8n. Senão, uma credencial genérica
Send Query Parameters	Filtros enviados na URL
Send Headers	Cabeçalhos exigidos pela API
Send Body	Corpo da requisição, em JSON, formulário ou arquivo

A documentação recomenda a credencial predefinida quando ela existe. Ela já sabe como autenticar no serviço. As credenciais genéricas incluem Basic auth, Header auth, Query auth e OAuth2.

Leia a resposta

Por padrão, o node devolve só o corpo da resposta e considera sucesso apenas os códigos 2xx. Em Add Option > Response você muda isso:

• Include Response Headers and Status devolve cabeçalhos e código de status junto do corpo.
• Never Error trata qualquer código como sucesso, útil quando você quer decidir no workflow o que fazer com um 404.
• Response Format força JSON, texto ou arquivo.

Muitos itens, muitas chamadas

Como qualquer node, o HTTP Request faz uma chamada por item recebido. Para respeitar o limite de requisições da API, use a opção Batching, que define quantos itens vão por lote e o intervalo entre os lotes. Para respostas divididas em páginas, use a opção Pagination depois de conferir na documentação da API como ela pagina os resultados.