Clase 02 · Módulo 05
HTTP Request: conectar cualquier servicio
HTTP Request: conectar cualquier servicio
Qué logras en esta clase
Llamas la API de cualquier servicio desde n8n, aunque no exista un nodo para él.
- Armas una petición completa en el nodo HTTP Request.
- Importas un ejemplo en curl y lo revisas antes de confiar.
- Lees la respuesta, su código y sus cabeceras.
02
Un nodo para todo lo que tenga API
n8n trae cientos de nodos de servicios. HTTP Request cubre todos los que faltan, y las operaciones que a esos nodos no les pusieron.
03
Nodo del servicio o HTTP Request
| Situación | Usa |
|---|---|
| Hay nodo y tiene la operación | El nodo del servicio |
| Hay nodo, falta la operación | HTTP Request con la credencial de ese servicio |
| No hay nodo | HTTP Request |
El nodo del servicio te ahorra leer documentación y ya maneja la autenticación. HTTP Request te da control total a cambio de armar la petición tú. Parte siempre por el primero.
04
Los campos del nodo
| Campo | Qué pones |
|---|---|
| Method | El método: GET, POST, PUT, PATCH, DELETE y otros |
| URL | La dirección completa |
| Authentication | La credencial (clase 3) |
| Send Query Parameters | Parámetros de consulta |
| Send Headers | Cabeceras |
| Send Body | El cuerpo |
Son las cinco piezas de la clase anterior, cada una con su lugar. Los tres últimos son interruptores: al activarlos aparecen sus campos.
05
Tu primera llamada
- Agrega un Manual Trigger y después un nodo HTTP Request.
- Deja Method en GET.
- En URL escribe
https://api.github.com/repos/n8n-io/n8n/releases. - Deja Authentication en None: esta lectura es pública.
- Ejecuta el nodo y abre el panel de salida.
Deberías ver varios ítems, uno por cada versión publicada de n8n.
06
Parámetros de consulta
Activa Send Query Parameters. En Specify eliges cómo escribirlos:
- Using Fields Below: un par nombre y valor por parámetro; sumas más con Add Parameter.
- Using JSON: todos juntos en un objeto JSON.
Agrega per_page con valor 5 y ejecuta: llegan cinco ítems.
07
Cabeceras
Activa Send Headers y agrega una por fila, igual que los parámetros.
| Name | Value |
|---|---|
Accept | application/vnd.github+json |
User-Agent | practica-n8n |
Son las que GitHub pide en su documentación: la primera fija el formato de respuesta y la segunda identifica quién llama. Cada servicio pide las suyas.
08
Enviar un cuerpo
Activa Send Body y elige el Body Content Type que pide la documentación.
| Tipo | Cuándo |
|---|---|
| JSON | La gran mayoría de las API |
| Form URLencoded | Servicios que reciben datos como formulario |
| Form-Data | Formulario que además lleva archivos |
| n8n Binary File | Enviar solo un archivo |
| Raw | Otro formato, como XML o texto |
Si la documentación muestra Content-Type: application/json, es JSON.
09
Cuerpo JSON: campos o texto
Con JSON, Specify Body ofrece dos formas:
- Using Fields Below: nombre y valor por campo. Sirve para cuerpos planos.
- Using JSON: escribes el objeto completo. Necesario cuando hay objetos dentro de objetos o listas.
En ambas puedes usar expresiones (módulo 3) para meter datos de nodos anteriores.
10
Si hay un curl, no lo copies a mano
La documentación ya trae la petición armada. Importarla toma diez segundos y evita errores de tipeo en cabeceras y cuerpo.
11
Importar un ejemplo en curl
- Copia el ejemplo en curl desde la documentación del servicio.
- En la pestaña Parameters del nodo, pulsa Import cURL.
- Pega el comando en la ventana que se abre.
- Pulsa Import.
El nodo queda con método, URL, cabeceras y cuerpo completados.
12
Revisa lo que quedó tras importar
- La clave: si el curl traía
Authorization, quedó escrita a la vista en las cabeceras. Bórrala de ahí y pásala a una credencial (clase 3). - Los tipos: los valores importados quedan como texto. Si la API exige un número o un verdadero/falso, cambia a Using JSON y escribe el objeto.
- Los valores de ejemplo: reemplaza
TU_CLAVE, identificadores y correos de muestra.
13
Cómo llega la respuesta
- Si el servicio devuelve un objeto, recibes un ítem.
- Si devuelve una lista, recibes un ítem por elemento.
- Si la lista viene dentro de un campo, como
dataoresults, recibes un solo ítem; sepárala con Split Out (módulo 3).
14
Ver código y cabeceras
Por defecto solo ves el cuerpo. En Add Option elige Response:
| Opción | Efecto |
|---|---|
| Include Response Headers and Status | Agrega cabeceras y código a la salida |
| Response Format | Autodetect, JSON, Text o File |
| Never Error | El nodo no falla aunque el código sea de error |
Con la primera activada, los datos pasan a estar dentro de un campo del ítem. Ajusta las expresiones de los nodos siguientes.
15
Cuándo sirve Never Error
Normalmente un 404 o un 500 detiene el flujo, y eso es lo correcto. Never Error conviene cuando el error es una respuesta esperada.
Úsalo junto con Include Response Headers and Status, o no sabrás qué pasó.
16
Una llamada por cada ítem
Si al nodo le llegan 50 ítems, hace 50 llamadas. Es la regla del módulo 3, y aquí cada vuelta gasta cuota de un servicio ajeno.
17
Controlar cuántas llamadas haces
- Una por ítem: para «consultar el estado de cada pedido». Es lo normal.
- Una sola: para «traer la lista de productos», aunque lleguen muchos ítems. Activa Execute Once en la pestaña Settings (módulo 4).
- Muchas, pero espaciadas: con las opciones de la clase 4.
18
Usar datos anteriores en la llamada
Todos los campos aceptan expresiones. Lo más común es armar la dirección con un dato del ítem:
https://api.ejemplo.com/v1/pedidos/{{ $json.id_pedido }}19
Otras opciones que conviene conocer
| Opción | Para qué |
|---|---|
| Timeout | Milisegundos máximos de espera antes de abortar |
| Redirects | Seguir redirecciones; viene activado |
| Batching y Pagination | Lotes y páginas (clase 4) |
| Ignore SSL Issues | Aceptar certificados inválidos |
20
Archivos por HTTP
- Descargar: en Response pon Response Format en File y elige el campo en Put Output in Field. El archivo llega como dato binario.
- Subir: en Send Body usa n8n Binary File, o Form-Data con un parámetro de tipo n8n Binary File, e indica el nombre del campo binario en Input Data Field Name.
Cómo viajan los archivos dentro de un flujo se vio en el módulo 3, clase 6.
21
Cuando la llamada falla
- Lee el código y el mensaje del servicio en el panel de salida.
- Con 400, compara tu cuerpo con el ejemplo de la documentación, campo por campo.
- Con 401 o 403, revisa la credencial y sus permisos.
- Con 404, revisa la URL y los valores de las expresiones.
- Con 5xx, espera y vuelve a ejecutar.
Si no lo ves, entrégale a Claude la petición sin la clave y el error completo.
22
Errores comunes
- Dejar la clave escrita en Send Headers después de importar un curl.
- Elegir Form-Data cuando la API esperaba JSON, o al revés.
- Probar un POST real varias veces y crear registros duplicados.
- Asumir que la respuesta es una lista cuando venía dentro de un campo.
- Activar Never Error en todo y no enterarse nunca de las fallas.
23
Lo que te llevas
- HTTP Request llama cualquier API; el nodo del servicio va primero cuando existe.
- Parámetros, cabeceras y cuerpo tienen cada uno su interruptor.
- Import cURL arma la petición, pero hay que sacar la clave y revisar los tipos.
- El nodo hace una llamada por ítem.
- Código y cabeceras se ven activando una opción de Response.
24
Hazlo ahora
En 15 minutos, con la llamada a https://api.github.com/repos/n8n-io/n8n/releases:
- Agrega
per_pageigual a3como parámetro de consulta y las dos cabeceras de la clase. - Activa Include Response Headers and Status y busca la cabecera
x-ratelimit-remaining: son las llamadas que te quedan esta hora. - Cambia
n8npor un repositorio inventado y mira cómo falla el nodo. - Activa Never Error, ejecuta de nuevo y ubica el código 404 en la salida.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026