Перейти к содержанию

Код в n8n: JavaScript, Python, HTTP Request и expressions

Обновлено: 2026-05-29

Открыть мой план

n8n не требует писать код для каждого workflow, но код помогает там, где no-code-настройки становятся громоздкими: сложная нормализация JSON, группировка, подпись API-запроса, подготовка отчёта или нестандартный сервис.

Карта раздела

  • Code node — как возвращать items и не ломать данные.
  • JavaScript — map/filter/reduce, дедупликация, группировка.
  • Python — когда выносить логику во внешний сервис.
  • HTTP Request — REST API, headers, body, auth.
  • HTTP Request API guide — подключение сервиса без готовой ноды.
  • Шпаргалка выражений — готовые примеры $json, $node, дат и fallback.

Когда код оправдан

Код нужен для массивов, сложных payload, удаления дублей, нестандартного API и алгоритмов. Но простое переименование поля лучше делать через Set/Edit Fields, а не через Code node.

Главное правило

Code node должен возвращать массив items с json. Если вернуть обычный объект или строку, следующая нода не получит ожидаемые данные. Для workflow с несколькими items учитывайте item linking.

Инженерный контракт для кода в n8n

Статья Код в n8n: JavaScript, Python, HTTP Request и expressions должна помогать писать код, который не ломает data flow. До Code node нормализуйте вход, внутри кода явно обрабатывайте пустые поля и arrays, после кода возвращайте предсказуемый JSON. Если количество output items отличается от input items, отдельно проверьте item linking.

  • не храните secrets в коде: используйте credentials или env, если это допустимо в вашей схеме
  • не смешивайте парсинг, бизнес-решение и HTTP-вызов в одном фрагменте без причины
  • оставляйте примеры входа/выхода рядом с workflow или в комментарии
  • для production добавляйте тесты на пустой, частичный и неожиданный payload
  • если выражение можно сделать без Code node — сначала оцените более простую ноду

Как пользоваться этим разделом

Раздел про код закрывает ситуации, где стандартных нод недостаточно: нормализация payload, сложные условия, JSON parsing, custom retry и подготовка данных для API.

Код в n8n должен быть маленьким, проверяемым и документированным; бизнес-логику лучше не прятать в один огромный Code node.

Маршрут чтения

  • Сначала откройте обзорную страницу и проверьте, совпадает ли задача с вашим интентом.
  • Затем перейдите в конкретный рецепт, ошибку, ноду или интеграцию.
  • После настройки workflow вернитесь к production-чеклисту: credentials, retry, логирование, backup и owner процесса.
  • Если страница используется в работе команды, добавьте её в runbook или внутреннюю базу знаний.

Практический контекст для внедрения

Эта страница полезна не как абстрактная справка, а как рабочая инструкция под тему «Код в n8n: JavaScript, Python, HTTP Request и expressions» в практическом внедрении n8n. Перед изменением workflow зафиксируйте источник события: HTTP/Webhook событие от внешней системы с подписью, timestamp и payload. Так проще отделить ошибку данных от ошибки настройки n8n и не превратить исправление в набор случайных правок.

Минимальная проверка перед публикацией workflow: один happy path, один пустой payload, один повтор события и одна ошибка внешнего сервиса. Для мониторинга используйте status code distribution, retry count, payload size, dedupe hit rate; эти показатели быстро покажут, что сценарий работает иначе, чем ожидалось.

Что читать дальше

Начните с Code node и HTTP Request.

Чеклист кода

Код в n8n должен уменьшать сложность, а не прятать бизнес-логику. Если задачу можно ясно решить через Set, IF или Switch, лучше оставить её визуальной. Code node стоит использовать для массивов, агрегатов, сложного форматирования и нестандартных API-подписей.

  • На выходе всегда массив items с полем json.
  • Секреты берутся из credentials, а не из текста кода.
  • Ошибки и пустые поля обработаны явно.
  • После Code node проверен item linking, если дальше используются данные предыдущих нод.

Как тестировать

Проверяйте код минимум на трёх входах: обычный item, item с пустыми необязательными полями и item с неожиданным типом данных. Это быстрее, чем разбирать production execution после того, как внешний API прислал новый формат ответа.

Практическое применение страницы

Материал «Код в n8n: JavaScript, Python, HTTP Request и expressions ¶» лучше использовать как точку входа в рабочий маршрут, а не как изолированную справку. Перед внедрением выберите конкретный процесс, источник данных, владельца и ожидаемый результат. Это помогает быстро понять, какая страница базы нужна дальше: рецепт, диагностика, интеграция, нода или production-playbook.

Для любой автоматизации в n8n полезно заранее описать входной item, обязательные поля, внешние сервисы, write-действия и способ отката. Если эти детали не зафиксированы, даже простой workflow может стать неуправляемым: дублирует заявки, теряет часть items, отправляет уведомления не тем людям или ломается при изменении формата API.

Минимальный чеклист

  • Определите, что является успешным результатом и кто его подтверждает.
  • Проверьте happy path, пустой вход, повтор события и сбой внешнего сервиса.
  • Добавьте логирование execution id, source, external id и статуса без секретов.
  • Свяжите страницу с ближайшим рецептом, ошибкой или playbook.
  • Навигатор — открыть связанный материал для проверки контекста.
  • Диагностика — открыть связанный материал для проверки контекста.
  • Рецепты — открыть связанный материал для проверки контекста.
  • Playbooks — открыть связанный материал для проверки контекста.