Что это
n8n API - интерфейс управления самой платформой автоматизации. Он подходит для инвентаризации workflows, проверки выполнений и согласованного управления сценариями. Это не то же самое, что HTTP Request node, который обращается к стороннему сервису.
Авторизация использует ключ в заголовке X-N8N-API-KEY. В Enterprise можно ограничить его scopes. В других редакциях ключ имеет полный доступ к ресурсам и возможностям своей учетной записи; намерение делать только GET не превращает его в read-only ключ.
API доступен в self-hosted редакциях и платных Cloud-планах, но не в облачном бесплатном trial. Вызов API не создает AI-агента, память или подключение модели: эти возможности настраиваются в самом workflow. Для первого теста достаточно прочитать один учебный сценарий.
Ключевые параметры
- Категория: Автоматизация
- Сложность: Для разработчика
- Запуск: Около 30 минут
- Open-source: Нет
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- Управление по HTTP не зависит от расположения элементов редактора.
- API-ключ имеет имя и срок действия, поэтому его проще учитывать и заменять.
- Enterprise scopes позволяют ограничивать ключ под конкретную задачу.
- Cursor-пагинация позволяет собирать списки частями и проверять полноту.
Ограничения
- API не доступен на бесплатном облачном trial.
- Вне Enterprise ключ не ограничивается отдельными scopes и дает доступ в рамках всей учетной записи.
- Методы управления могут изменять сценарии; ключ нельзя выдавать модели без контролируемого посредника.
- Доступный набор методов зависит от версии и редакции, а self-hosted требует сопровождения.
Как использовать
1. Подготовка. Возьмите отдельный учебный self-hosted экземпляр или разрешенный платный Cloud. Создайте неактивный workflow с понятным названием, без рабочих credentials. Первый запрос будет только читать список.
2. Настройка. Откройте Settings > n8n API, создайте ключ с коротким сроком. В Enterprise выберите только workflow:list. Если scopes недоступны, используйте отдельный учебный экземпляр и не называйте ключ read-only. Храните ключ как секрет.
3. Первый результат. Выполните GET https://ВАШ_N8N/api/v1/workflows?limit=1 с заголовками X-N8N-API-KEY: TOKEN и Accept: application/json. В локальной изолированной установке используйте ее фактический адрес. Получите data и при наличии nextCursor.
4. Проверка. Сверьте ID и название с редактором. Одну строку не называйте полным перечнем: следующую страницу запрашивают через cursor. Убедитесь, что workflow не активировался и не изменился. Проверьте ошибки доступа; не добавляйте операции credentials, удаления и активации в первый тест.
Доступ и оплата
- Модель оплаты: Self-hosted
- Бесплатный тариф: Да
- Пробный доступ: Нет
- Работа в РФ: Нужно проверять
- VPN: Не известно
- Русский интерфейс: Не известно
- Русский язык: Не известно
У self-hosted Community нет отдельной платы за лицензию публичного API, но есть ограничения Sustainable Use License и затраты на сервер. Это не OSI open-source. Cloud Starter, Pro и Enterprise дают API; Cloud trial - нет. Российскую оплату здесь не проверяли.
Когда не подходит
- Считать любой ключ ограниченным чтением
- Искать API в бесплатном Cloud trial
- Запускать произвольный workflow недокументированным методом
Альтернативы
Редактор n8n удобнее для разового просмотра и ручной настройки. Make API относится к Make. Zapier Platform предназначена для интеграций экосистемы Zapier; она не управляет вашим n8n и не является точной заменой его API.