Основи JSON

JSON по суті є шаблоном, де одні й ті ж поля завжди з'являються на тих самих місцях. Майже все в n8n базується на двох основних структурах: Об'єкти та Масиви. Дані передаються між вузлами у вигляді масиву елементів, де кожен елемент містить об'єкт $json. Коли структура послідовна, робочі процеси виконуються безперебійно; якщо ні — вузли починають працювати некоректно.

Об'єкт із іменованими полями

Фігурні дужки { } позначають об'єкт — структурований запис, що складається з пар ключ–значення. Це можна уявити як один рядок електронної таблиці, де кожен заголовок стовпця (ключ) має відповідне значення в комірці.

Масив або список елементів

Список значень. Використовується, коли потрібні прості елементи у певному порядку:

Список об'єктів. Використовується, коли кожен елемент має власні поля або атрибути:

Квадратні дужки [ ] позначають масив — впорядкований список елементів. Це можна уявити як декілька рядків електронної таблиці, кожен з яких містить подібно структуровані дані.

Це основні типи даних, з яких складається будь-яка структура JSON.

Більшість API-навантажень є просто комбінаціями цих базових елементів.

Як n8n фактично представляє JSON

У n8n кожен вузол виводить дані у послідовній структурі: масив елементів, де кожен елемент містить об'єкт $json. Ви можете переглядати та змінювати ці дані різними способами, але базова структура завжди залишається незмінною.

• Кожен вузол виводить масив елементів, кожен з яких містить об'єкт $json;
• Доступ до конкретних полів здійснюється за допомогою виразів, наприклад {{$json["customer"]["first_name"]}};

• Перемикайтеся між переглядами Schema, Table та JSON — вони відображають ті самі дані по-різному;

• Використовуйте Split Out / Item Lists для розбиття масивів на окремі елементи;
• Використовуйте Aggregate / Item Lists для об'єднання кількох елементів назад у єдиний список для AI або пакетної обробки.