n8n добавил встроенную идемпотентность API для надёжных воркфлоу

Что изменилось?

В блоге n8n от 3 сентября 2026 г. объявлен запуск встроенной поддержки идемпотентности API. Теперь каждый HTTP‑запрос в ноде HTTP Request может быть снабжён idempotency‑key, которую платформа сохраняет и проверяет при последующих вызовах.

Ключевые детали

• Idempotency‑key генерируется автоматически (UUID) или задаётся вручную в параметрах ноды.
• По умолчанию ключ хранится в базе данных n8n и привязывается к конкретному workflow‑execution, что гарантирует, что повторный запрос в рамках одной сессии будет проигнорирован.
• Возможна кастомная реализация хранилища через внешние базы (PostgreSQL, Redis) – достаточно указать путь в настройках.
• Поддерживаются популярные сценарии: платежные шлюзы, создание ресурсов в облаке, отправка писем и т.д.
• В тестах компании n8n дублирование запросов сократилось на 95 %, а время отладки – на 30 %.

Как это выглядит на практике?

- node: HTTP Request
  parameters:
    url: https://api.payment.com/charge
    method: POST
    body: {...}
    idempotencyKey: {{$json["orderId"]}}

Если воркфлоу выполнится дважды из‑за ошибки сети, второй запрос будет отклонён, а результат – возвращён из кэша.

Почему это важно?

Идемпотентность устраняет один из самых болезненных багов в интеграционных проектах – непреднамеренное дублирование действий, которое может вести к двойным списаниям, созданию дублирующих записей и другим нежелательным последствиям.

Подробности и примеры – в оригинальном посте: n8n Blog: How To Build Reliable Workflows With API Idempotency.