Cómo viajan los datos entre nodos
Hay una sola frase que hay que interiorizar antes de tocar cualquier expresión:
> “In n8n, all data passed between nodes is an array of objects.”
Siempre un array, incluso cuando hay un único resultado. Cada objeto de ese array es un item, y cada item tiene dos zonas: la clave json, con los datos estructurados, y la clave binary, con los archivos que lo acompañan.
Dentro de una entrada binaria, el campo data guarda el contenido codificado en base64 y es obligatorio. Los campos mimeType, fileExtension y fileName son opcionales, aunque la documentación los recomienda como buena práctica: sin ellos, el archivo viaja sin decir qué es ni cómo se llama.
El bucle que no se ve
> “Nodes process multiple items automatically. When a node receives an array of data items, it processes each item individually and performs the configured operation for each one.”
No hace falta un nodo de bucle para aplicar una operación a cien items: el nodo ya repite. Ese comportamiento explica también por qué un nodo puede llamar cien veces a una API sin que nadie lo haya pedido explícitamente.
Dos excepciones y un atajo
El nodo Code (y el antiguo Function) agrega la clave json si falta y envuelve los items en un array cuando hace falta. Esa comodidad existe solo ahí.
El atajo: arrastrar un campo desde el panel INPUT hasta un parámetro genera la expresión que lo referencia.