Introducción

El nodo HTTP Request es la navaja suiza de n8n. Cuando no existe una integración nativa para el servicio que necesitas, este nodo te permite llamar a cualquier API REST directamente: GET, POST, PUT, PATCH, DELETE, todo. Cuando vuelve la respuesta, n8n te entrega el payload JSON completo y usas expresiones para extraer exactamente los campos que te interesan.

Esta lección recorre el ciclo completo: configurar el nodo, lanzar la petición, leer la estructura de la respuesta y conectar valores específicos al siguiente paso de tu workflow.

Configurar el nodo HTTP Request

Añade un nodo HTTP Request a tu canvas y rellena primero tres cosas: el método HTTP, la URL y la autenticación (si la API lo requiere).

Para un endpoint público que no necesita autenticación, un GET mínimo se ve así en el campo de expresión de n8n para la URL:

https://api.open-meteo.com/v1/forecast?latitude=51.5&longitude=-0.1&current_weather=true

Para una API que necesita una clave, ve a la sección Authentication, elige Header Auth y establece el nombre del encabezado (comúnmente Authorization) y el valor (comúnmente Bearer YOUR_TOKEN). Puedes guardar el token en una Credential de n8n para que nunca quede codificado en el nodo.

Cuando necesites enviar un cuerpo JSON —por ejemplo, en una petición POST que crea un recurso— establece Body Content Type como JSON y escribe el payload en el campo Body:

{
  "name": "{{ $json.customerName }}",
  "email": "{{ $json.customerEmail }}"
}

La sintaxis de doble llave es el motor de expresiones de n8n, que obtiene valores del resultado del nodo anterior en tiempo de ejecución.

Leer la estructura de la respuesta

Después de hacer clic en Execute Node, n8n muestra la respuesta en el panel de Salida a la derecha. Cada respuesta expone tres cosas: código de estado, encabezados y cuerpo. Por defecto, n8n analiza automáticamente un cuerpo JSON y lo devuelve como datos estructurados que puedes recorrer.

Supón que la API de Open-Meteo devuelve esto:

{
  "latitude": 51.5,
  "longitude": -0.1,
  "current_weather": {
    "temperature": 14.2,
    "windspeed": 11.3,
    "weathercode": 3
  }
}

En el panel de Salida puedes hacer clic en el árbol para ver cada campo anidado. Este paso de exploración es importante: hazlo antes de escribir cualquier expresión, así conoces la ruta exacta de la clave.

Si la API devuelve una respuesta que no es JSON (texto plano, XML), activa la opción Return Full Response y cambia Response Format a Text; luego gestiona el análisis manualmente en un nodo Code aguas abajo.

Extraer datos con expresiones

Una vez que conoces la estructura, referencias los campos usando la sintaxis de expresiones de n8n en cualquier nodo aguas abajo. La raíz del resultado del HTTP Request siempre es accesible mediante el nombre del nodo.

Para tomar la temperatura del ejemplo anterior en el siguiente nodo:

{{ $node["HTTP Request"].json["current_weather"]["temperature"] }}

O, si estás dentro del nodo inmediatamente posterior (el nodo anterior implícito), usa la forma abreviada:

{{ $json["current_weather"]["temperature"] }}

Cuando la API devuelve un array —por ejemplo, una lista de pedidos—, el cuerpo de la respuesta es en sí mismo el array, o está anidado bajo una clave como data. Para iterarlo, conecta el nodo HTTP Request a un nodo Split In Batches o usa el nodo Item Lists configurado como Split Out Items; así cada ejecución aguas abajo recibe un elemento a la vez.

Así es como referenciarías el campo id del tercer elemento directamente, sin dividir (indexado desde cero):

{{ $json["data"][2]["id"] }}

Errores comunes

La ausencia del encabezado Content-Type es el problema más frecuente al enviar datos por POST. Si estableces Body Content Type como JSON, n8n añade el encabezado automáticamente. Si cambias a Raw, añade el encabezado a mano: Content-Type con el valor application/json.

Otro error habitual es intentar referenciar un campo que está un nivel más profundo de lo esperado. Usa siempre el panel de Salida para verificar la ruta exacta antes de escribir expresiones: las suposiciones sobre la forma de las respuestas de la API suelen ser incorrectas.

La limitación de tasa (rate limiting) es el tercer problema. Si tu workflow se ejecuta con frecuencia contra la misma API, añade un nodo Wait entre iteraciones y revisa en la documentación de la API los encabezados de límite (Retry-After, X-RateLimit-Remaining). n8n no gestiona el rate limiting automáticamente.

Resumen

El nodo HTTP Request se resume en tres acciones: establecer el método y la URL, autenticar si es necesario y enviar un cuerpo opcional. Tras la ejecución, usa el panel de Salida para explorar el árbol de la respuesta y luego referencia campos específicos en nodos aguas abajo con expresiones usando la forma abreviada $json o $node["NodeName"].json para acceder entre nodos. Para respuestas en array, divide los elementos antes de procesarlos individualmente. Dominar este ciclo te permite integrarte prácticamente con cualquier API REST en n8n.