Nodo HTTP Request n8nConfigura HTTP Request en n8n.

El selector de arriba fija el verbo que viaja por la red, y el resto del panel se adapta. Una lectura usa GET, una escritura POST o PUT, una actualización parcial PATCH.

• Method: siete opciones, DELETE, GET, HEAD, OPTIONS, PATCH, POST y PUT, según lo que pida la documentación de la API.

El endpoint que escribes aquí es donde aterriza la llamada, y es el único campo sin el cual el nodo no arranca. Las expresiones también caben, así que la ruta puede cambiar en cada item.

• URL: el endpoint completo, con la forma http://example.com/index.html, a menudo construido desde el nodo anterior con {{ $json.id }} dentro de la ruta.

Tres maneras de demostrar quién llama caben en este selector, y la elección decide qué campo aparece justo debajo.

• None (none): no se adjunta nada a la petición.
• Predefined Credential Type (predefinedCredentialType): la autenticación que n8n ya implementó, elegida en Credential Type, recomendada cuando el servicio está disponible.
• Generic Credential Type (genericCredentialType): totalmente configurable desde Generic Auth Type, de Basic auth a OAuth2 API.

Hay servidores que esperan que quien llama presente su propio certificado antes de empezar la conversación. Este interruptor es el que lo ofrece.

• SSL Certificates: un interruptor simple, apagado mientras el destino no exija certificado de cliente.

Los parámetros de consulta actúan como filtros de la petición. Actívalo cuando la API los admita y la llamada necesite acotarse.

• Specify Query Parameters: keypair (Using Fields Below) para pares de nombre y valor añadidos uno a uno, o json (Using JSON).
• Query Parameters: los pares en sí, ampliados con Add Query Parameter.
• JSON: los mismos filtros escritos como un único objeto.

Las cabeceras llevan metadatos y contexto de la llamada, lo primero que lee una API antes de mirar nada más. Este interruptor abre los campos que las contienen.

• Specify Headers: keypair (Using Fields Below) para pares de nombre y valor, o json (Using JSON).
• Headers: los pares, añadidos con Add Header.
• JSON: el conjunto de cabeceras como un objeto.

Crear o modificar un dato implica mandar contenido junto a la llamada. Activa el interruptor y elige el formato que documenta la API.

• Body Content Type: json (JSON), form-urlencoded (Form Urlencoded), multipart-form-data (Form-Data), binaryData (n8n Binary File) o raw (Raw).
• Specify Body: campos explícitos (keypair) u objeto JavaScript (json), rellenados con Body Parameters, JSON o un único Body del tipo field1=value1&field2=value2.
• Input Data Field Name: el campo de entrada que trae el archivo binario, junto a Content Type para un cuerpo en bruto.

Cada item de entrada se convierte en una petición, y una API con cuota lo nota enseguida. Esta opción los agrupa y respira entre grupos.

• Items per Batch: cuántos items entran en cada lote, con -1 para desactivar el reparto y 0 tratado como uno.
• Batch Interval (ms): la pausa entre lotes, 0 para ninguna. Con 1000 el ritmo baja a una petición por segundo.

Por defecto el nodo solo descarga la respuesta si la validación del certificado sale bien. Añadir esta opción deja pasar la respuesta aunque la validación falle.

• Ignore SSL Issues (Insecure): un único interruptor, apagado en uso normal, encendido cuando el certificado no se puede verificar.

Las API no se ponen de acuerdo en cómo se escribe un filtro repetido dentro de una URL, y esta opción zanja el formato. Solo aparece con Send Query Parameters activado.

• No Brackets (repeat): el nombre se repite, foo=bar&foo=qux.
• Brackets Only (brackets): corchetes tras cada nombre, foo[]=bar&foo[]=qux.
• Brackets with Indices (indices): corchetes con posición, foo[0]=bar&foo[1]=qux.

Los nombres de cabecera salen en minúsculas salvo que digas lo contrario. Encendido es el comportamiento por defecto, apagado conserva las mayúsculas tal como se escribieron.

• Lowercase Headers: un interruptor, útil solo ante un servicio que lee los nombres de cabecera al pie de la letra.

Cuando un servidor contesta con una dirección nueva, el nodo la sigue por defecto. Esta opción acota ese comportamiento o lo corta.

• Follow Redirects: encendido por defecto, apagado cuando quieres ver la propia respuesta de redirección y no su destino.
• Max Redirects: el tope de saltos que acepta la petición antes de rendirse.

Lo que sale del nodo se negocia. Esta opción le da forma, desde el formato hasta lo que cuenta como fallo.

• Include Response Headers and Status: devuelve la respuesta completa en vez de solo el cuerpo.
• Never Error: da por buena la ejecución aunque el código de estado no sea 2xx, y la gestión del error vuelve al flujo.
• Response Format: autodetect (Autodetect), json (JSON), text (Text) o file (File), los dos últimos escribiendo en Put Output in Field.

Las colecciones grandes llegan por trozos, y esta opción sigue pidiendo hasta completarlas. Mira antes una respuesta sin paginar para ver qué mecánica usa la API.

• Pagination Mode: off (Off), updateAParameterInEachRequest (Update a Parameter in Each Request) con sus Parameters, o responseContainsNextURL (Response Contains Next URL) con Next URL.
• Pagination Complete When: Response Is Empty, Receive Specific Status Code(s) con Status Code(s) when Complete, u Other con Complete Expression.
• Limit Pages Fetched y Max Pages, más Interval Between Requests (ms).

A veces el tráfico de salida tiene que pasar por una puerta concreta, sea por filtrado o para mantener una dirección de salida fija. Un solo campo se encarga.

• Proxy: el proxy HTTP que usará la petición, escrito como http://myproxy:3128, con prioridad sobre las variables de entorno globales HTTP_PROXY, HTTPS_PROXY y ALL_PROXY.

Un servidor que no contesta nunca es peor que uno que rechaza. Este valor limita cuánto espera el nodo las cabeceras de respuesta y el inicio del cuerpo antes de abortar.

• Timeout: la espera en milisegundos, por ejemplo 5000 en un endpoint que suele responder al instante.

Una redirección puede llevar a otro dominio distinto. Esta opción decide si los secretos hacen ese viaje.

• Send Credentials on Cross-Origin Redirect: un interruptor que permite que las credenciales, como la cabecera Authorization, sigan una redirección hacia un origen diferente.

Conectado a un agente de IA como herramienta, el nodo entrega su respuesta a un modelo, y una respuesta de API en bruto desperdicia tokens. Esta opción la adelgaza antes.

• Expected Response Type: json (JSON) con Field Containing Data, Include Fields (All, Selected, Except) y Fields; html (HTML) con Selector (CSS), Return Only Content y Elements To Omit; o text (Text).
• Truncate Response y Max Response Characters: un tope duro al tamaño.