Nodo HTTP Request n8n: Guía Avanzada para Conectar APIs

El nodo HTTP Request n8n es, sin dudas, el componente más versátil de toda la plataforma. Si n8n no tiene un nodo nativo para el servicio que necesitás, el nodo HTTP Request en n8n te permite conectar con cualquier API REST del mundo — sin límites. En esta guía avanzada vas a aprender todo lo que necesitás para dominarlo: autenticación, paginación, manejo de errores, envío de archivos y técnicas profesionales para APIs complejas. ¿Listo? Vamos a ello.

¿Qué es el nodo HTTP Request en n8n y por qué es tan importante?

Pensalo así: n8n tiene cientos de nodos nativos para servicios populares como Google Drive, Zoom o PayPal. Pero el mundo de las APIs es infinito. El nodo HTTP Request n8n es tu comodín universal: cualquier servicio que tenga una API REST (o incluso GraphQL), lo podés conectar.

Algunos escenarios típicos donde el nodo HTTP Request brilla:

• Conectar con APIs internas de tu empresa que no tienen nodo nativo
• Consumir APIs públicas de datos (clima, cotizaciones, geolocalización)
• Interactuar con servicios SaaS que solo ofrecen API REST
• Enviar webhooks salientes a servicios de terceros
• Descargar o subir archivos desde/hacia cualquier servidor

Si recién estás arrancando con la plataforma, te recomiendo primero pasar por el tutorial completo de n8n en español para tener una base sólida.

Configuración básica del nodo HTTP Request n8n

Parámetros principales del nodo HTTP Request

Cuando arrastrás el nodo HTTP Request al canvas de n8n, te vas a encontrar con estos parámetros esenciales:

Tu primera petición API con HTTP Request

Para probar que todo funciona, usemos la API pública de JSONPlaceholder. Configurá el nodo así:

• Method: GET
• URL: https://jsonplaceholder.typicode.com/posts/1
• Authentication: None

Ejecutá el nodo y listo: n8n hará la petición y el resultado estará disponible en $json para que lo uses en los nodos siguientes. Así de simple.

Autenticación en el nodo HTTP Request: todos los métodos

La autenticación es probablemente la parte más importante cuando trabajás con el nodo HTTP Request en n8n. Veamos todos los métodos disponibles.

API Key en header

El método más común. Tenés dos formas de configurarlo:

Forma directa:

• Authentication: Header Auth
• Name: Authorization
• Value: Bearer tu-api-key-aqui

Forma recomendada (usando credenciales de n8n):

1. Creá una credential de tipo Header Auth en la sección de credenciales
2. En el nodo: Authentication → Predefined Credential Type → Header Auth
3. Así tus claves quedan seguras y reutilizables en otros workflows

Basic Auth

Para APIs que usan el esquema clásico de usuario y contraseña:

• Authentication: Basic Auth
• n8n codifica automáticamente usuario:contraseña en base64
• No necesitás hacer la codificación vos mismo

Este método es común en APIs de servicios como PostgreSQL vía API REST o servicios empresariales legacy.

OAuth 2.0

Para servicios como Google, Microsoft o Salesforce que usan el protocolo OAuth:

1. Creá credenciales de tipo OAuth2 API en n8n
2. Configurá Client ID, Client Secret, Authorization URL y Token URL
3. Definí los scopes necesarios
4. n8n gestiona automáticamente el refresh token — no te tenés que preocupar por expiración

AWS Signature

Para APIs de Amazon Web Services que requieren firma v4:

• Authentication: AWS
• Configurá Access Key ID, Secret Access Key, Region y Service
• n8n firma cada petición automáticamente

Enviar datos en el body con el nodo HTTP Request n8n

JSON body

El formato más usado para crear o actualizar recursos en APIs REST:

• Method: POST
• Body Content Type: JSON

{
  "title": "{{ $json.titulo }}",
  "content": "{{ $json.contenido }}",
  "status": "publish"
}

Este ejemplo es perfecto si estás automatizando publicaciones en WordPress con n8n usando su API REST.

Form Data (URL Encoded)

Para APIs que esperan application/x-www-form-urlencoded:

• Body Content Type: Form-Data/URLEncoded
• Añadí los campos con su nombre y valor correspondiente
• n8n se encarga de codificar los caracteres especiales

Multipart/Form Data para subir archivos

Cuando necesitás subir un archivo binario:

• Body Content Type: Multipart Form Data
• Añadí un campo de tipo Binary
• Seleccioná la propiedad binaria del item que viene del nodo anterior
• Podés combinar campos binarios con campos de texto en la misma petición

Paginación en el nodo HTTP Request n8n: extraer todos los resultados

La mayoría de APIs devuelven resultados paginados. Sin un manejo correcto de paginación, solo vas a obtener la primera página. Acá es donde el nodo HTTP Request n8n realmente se luce con su sistema de paginación integrado.

Tipo 1: Offset/Limit (la más común)

Activá la paginación en la sección Options → Pagination del nodo:

• Pagination Mode: Update a Parameter in Each Request
• Parameter Type: Query
• Parameter Name: page (o offset según la API)
• Expression: {{ $pageCount }}
• Complete When: Expression → {{ $response.data.length === 0 }}

Tipo 2: Cursor (APIs modernas)

APIs como Notion, Slack o Stripe usan cursores. Configurá así:

Complete When: {{ !$response.body.next_cursor }}
Parameter Value: {{ $response.body.next_cursor }}

El nodo HTTP Request va a seguir pidiendo páginas mientras exista un cursor de continuación.

Tipo 3: Link Header (GitHub y similares)

Para APIs que usan el header Link con relación «next»:

• Usá el modo Response Contains Next URL
• Next URL Expression: {{ $response.headers.link?.match(/<([^>]+)>;\s*rel="next"/)?.[1] }}

Manejo de errores en el nodo HTTP Request n8n

Las APIs fallan. Mucho. Rate limits, timeouts, errores 500… Un workflow profesional necesita manejar estos casos. Veamos cómo hacerlo.

Reintentos automáticos

Para APIs con rate limiting o inestabilidad ocasional:

• En el nodo, desplegá Settings
• On Error: Retry on Fail
• Retry on Fail: activado
• Wait Between Retries: 1000ms (1 segundo)
• Max Tries: 3

Tip pro: Si la API devuelve un header Retry-After, podés usar un nodo Wait con expresión dinámica antes de reintentar.

Capturar errores con Error Trigger

Para workflows críticos, configurá la opción «Continue On Fail» en el nodo HTTP Request. Esto permite que el workflow siga ejecutándose incluso si la petición falla, y podés evaluar el código de estado en el nodo siguiente:

// En un nodo IF después del HTTP Request:
{{ $json.statusCode === 200 }}

Esto es especialmente útil cuando trabajás con webhooks en n8n y necesitás garantizar respuestas confiables.

Técnicas avanzadas con HTTP Request en n8n

Headers dinámicos y firmas HMAC

Cuando los headers cambian por cada petición (por ejemplo, firmas de seguridad), usá un nodo Code antes del HTTP Request:

// Nodo Code antes del HTTP Request:
const crypto = require('crypto');
const timestamp = Date.now().toString();
const body = JSON.stringify($input.first().json);
const signature = crypto.createHmac('sha256', 'tu-secret')
  .update(timestamp + body)
  .digest('hex');

return [{ json: { timestamp, signature, ...($input.first().json) } }];

Luego en el nodo HTTP Request configurá los headers así:

• Header X-Timestamp: {{ $json.timestamp }}
• Header X-Signature: {{ $json.signature }}

Encadenar múltiples llamadas API

Un patrón muy común es usar el resultado de un HTTP Request como input del siguiente. Por ejemplo:

1. Primer HTTP Request: Obtener lista de usuarios → GET /api/users
2. Split In Batches: Iterar sobre cada usuario
3. Segundo HTTP Request: Obtener detalle → GET /api/users/{{ $json.id }}/details
4. Merge: Combinar los datos

Podés complementar este patrón integrando los datos con herramientas como Google Sheets para sincronización bidireccional.

Llamadas a APIs GraphQL

El nodo HTTP Request n8n también funciona perfecto con GraphQL:

• Method: POST
• URL: el endpoint GraphQL del servicio
• Body Content Type: JSON

{
  "query": "{ users(first: 10) { edges { node { id name email } } } }",
  "variables": {}
}

Descargar archivos binarios

Para descargar un PDF, imagen o cualquier archivo:

• Method: GET
• Response Format: File
• El archivo queda disponible como dato binario para nodos posteriores

Casos de uso prácticos del nodo HTTP Request n8n

Veamos algunos ejemplos reales donde el nodo HTTP Request es indispensable:

Conectar con APIs de inteligencia artificial

Podés usar HTTP Request para llamar a cualquier modelo de IA. Por ejemplo, si querés integrar modelos como Claude API, Grok o DeepSeek, el nodo HTTP Request te da control total sobre los parámetros de la llamada.

Automatizar publicaciones en redes sociales

Muchas plataformas sociales ofrecen APIs REST. Con HTTP Request podés publicar contenido automáticamente en LinkedIn o incluso enviar mensajes de WhatsApp usando APIs de terceros.

Crear un agente de IA que consulte APIs externas

Combinando el nodo HTTP Request con un agente de IA en n8n, podés crear asistentes que consulten datos en tiempo real desde cualquier servicio.

Mejores prácticas para el nodo HTTP Request n8n

Después de trabajar extensivamente con este nodo, estas son las prácticas que te van a ahorrar dolores de cabeza:

1. Siempre usá credenciales de n8n en lugar de hardcodear API keys en el nodo
2. Activá «Continue On Fail» en workflows de producción para evitar que se detenga todo
3. Probá primero con herramientas como Postman para validar que la petición funciona antes de armarla en n8n
4. Usá el modo Split In Batches cuando procesés muchos items para evitar rate limiting
5. Documentá las URLs y parámetros usando notas sticky en el canvas de n8n
6. Configurá timeouts razonables: el default es 300 segundos, bajalo si no necesitás tanto
7. Revisá los response headers: muchas APIs incluyen información de rate limit que podés usar

Preguntas frecuentes sobre el nodo HTTP Request n8n

¿Qué diferencia hay entre el nodo HTTP Request y los nodos nativos de n8n?

Los nodos nativos (como el de Google Sheets o Slack) son interfaces preconfiguradas que simplifican la interacción con esos servicios. El nodo HTTP Request n8n es genérico: te da control total sobre la petición, pero tenés que configurar todo manualmente (URL, headers, autenticación, body). Usá nodos nativos cuando existan; HTTP Request cuando no haya alternativa.

¿Puedo enviar archivos con el nodo HTTP Request n8n?

Sí. Configurá el Body Content Type como Multipart Form Data y añadí un campo de tipo Binary. Podés subir imágenes, PDFs, videos o cualquier tipo de archivo que la API destino acepte.

¿Cómo manejo APIs que requieren OAuth 2.0 en el nodo HTTP Request?

Creá una credencial de tipo OAuth2 API en n8n con el Client ID, Client Secret, Auth URL y Token URL del servicio. El nodo HTTP Request n8n gestiona automáticamente la obtención y renovación de tokens.

¿Hay límite en la cantidad de peticiones que puedo hacer?

Desde n8n no hay límite propio. El límite lo pone la API destino (rate limiting). Usá reintentos automáticos y Split In Batches para respetar esos límites sin que tu workflow falle.

¿El nodo HTTP Request funciona con APIs GraphQL?

Absolutamente. Configurá el método como POST, el body como JSON e incluí tu query y variables de GraphQL. Funciona perfecto con APIs como GitHub GraphQL, Shopify o Hasura.

¿Listo para dominar el nodo HTTP Request n8n?

El nodo HTTP Request n8n es literalmente la puerta de entrada a cualquier servicio con API. Ahora que conocés la configuración básica, los métodos de autenticación, la paginación automática, el manejo de errores y las técnicas avanzadas, no hay API que se te resista. Empezá con una petición GET simple, anda sumando complejidad, y en poco tiempo vas a estar construyendo workflows que conectan decenas de servicios. Para seguir profundizando, consultá la documentación oficial del nodo HTTP Request de n8n.