JSON é essencialmente um padrão, com os mesmos campos aparecendo nos mesmos lugares todas as vezes. Quase tudo no n8n depende de dois formatos principais: Objetos e Arrays. Os dados circulam entre os nós como um array de itens, onde cada item contém um objeto $json. Quando a estrutura é consistente, os fluxos de trabalho funcionam sem problemas; quando não está, os nós começam a apresentar comportamentos inesperados.

Objeto com Campos Nomeados

Chaves { } representam um objeto, um registro estruturado composto por pares de chave–valor. Pode ser comparado a uma única linha de planilha, onde cada cabeçalho de coluna (chave) possui um valor de célula correspondente.

Array ou Lista de itens

Uma lista de valores. Utilizada quando são necessários apenas itens simples em ordem:

Uma lista de objetos. Utilizada quando cada item possui seus próprios campos ou atributos:

Colchetes [ ] representam um array, uma lista ordenada de itens. Pode ser comparado a várias linhas de uma planilha, cada uma contendo dados com estrutura semelhante.

Estes são os principais tipos de dados que compõem toda estrutura JSON.

A maioria dos payloads de API são simplesmente combinações desses blocos de construção.

Como o n8n Representa JSON

No n8n, cada nó gera dados em uma estrutura consistente: um array de itens, onde cada item contém um objeto $json. É possível visualizar e manipular esses dados de diferentes formas, mas a estrutura subjacente permanece sempre a mesma.

• Cada nó gera um array de itens, cada um contendo um objeto $json;
• Acesse campos específicos usando expressões como {{$json["customer"]["first_name"]}};

• Alterne entre as visualizações Schema, Table e JSON, que exibem os mesmos dados de maneiras diferentes;

• Utilize Split Out / Item Lists para dividir arrays em itens individuais;
• Utilize Aggregate / Item Lists para combinar vários itens novamente em uma única lista para processamento em lote ou por IA.