API-ключ n8n: как подключиться и получить список автоматизаций
Создание API-ключа n8n, подключение встроенной ноды и получение списка workflow для ревизии без программирования.
У команды накопились автоматизации, и ты хочешь получить их список для ревизии. Для этого можно обратиться к API самого n8n. Начнём с чтения нескольких workflow через встроенную ноду n8n: писать программу не потребуется.
1. Уточни, какой именно ключ нужен
Ключ n8n даёт доступ к возможностям твоего экземпляра n8n. Ключ OpenAI или другой модели используется для обращения к соответствующему поставщику. Один не заменяет другой. В этой инструкции мы получаем список автоматизаций, поэтому нужен ключ именно n8n.
По документации авторизации, API недоступен в бесплатном пробном периоде. В Enterprise можно ограничивать ключ областями доступа. В остальных вариантах ключ предоставляет широкие возможности в пределах доступа аккаунта. Выбор операции чтения в учебном workflow сам по себе не ограничивает права ключа.
Для упражнения используй тестовый экземпляр или согласованный с администратором аккаунт. Результат не нужно отправлять внешней модели: названия и конфигурации автоматизаций могут раскрывать внутренние процессы.
2. Создай ключ с понятным назначением
Открой Settings → n8n API → Create API key. Задай название, например «Ревизия автоматизаций», и срок действия. Если доступны области доступа, оставь необходимые для чтения списка workflow. Сохрани созданный секрет в менеджере паролей.
Ключ не должен попадать в заметку с результатами ревизии или снимок экрана. В командной памятке достаточно названия подключения, владельца и даты истечения. Если ключ случайно раскрыт, отзови его и создай новый: редактирование опубликованного сообщения не отменяет уже полученный доступ.
Если раздел API отсутствует, сначала проверь доступность функции для аккаунта и права пользователя. Не пытайся заменить ключ паролем от n8n или токеном другой интеграции.
3. Настрой подключение во встроенной ноде
Создай новый workflow с ручным запуском — Manual Trigger. Добавь встроенную ноду n8n, а не AI Agent и не ноду поставщика модели. Создай для неё credentials типа n8n API и заполни API Key и Base URL.
Base URL должен вести к корню API твоего экземпляра и оканчиваться на /api/v1. Для облачного аккаунта используй адрес своего пространства n8n, для собственного сервера — его внешний адрес с этим окончанием. Не копируй адрес страницы конкретного workflow. Если сервер размещён за дополнительным префиксом пути, уточни адрес API у администратора.
При прямом HTTP-запросе ключ передаётся в заголовке X-N8N-API-KEY. В нашем сценарии credentials избавляют от необходимости вручную собирать заголовок. Не помещай ключ в обычное текстовое поле данных workflow.
4. Получи небольшую выборку
В ноде выбери ресурс Workflow и операцию Get Many. Выключи Return All, установи Limit = 3. Для первого запуска не добавляй фильтры: так проще отличить пустой результат от слишком строгого отбора. Эти параметры описаны в справке ноды n8n.
Запусти шаг вручную и открой Output. Ожидаемый результат — до трёх workflow, доступных аккаунту. Если их меньше, это не ошибка само по себе. Сопоставь идентификатор и название хотя бы одного результата с интерфейсом n8n. Не выбирай операции изменения, удаления или публикации для проверки подключения.
Если видишь ошибку авторизации, проверь ключ, срок и выбранный экземпляр. При отказе в доступе проверь права. При ошибке адреса сравни Base URL с настройкой сервера. Не добавляй бесконечные повторы: неверные credentials от них не исправятся.
5. Преврати список в план ревизии
API показывает существование workflow, но не доказывает его полезность или исправность. Назначение и владельца нужно уточнять отдельно. Для обсуждения используй такую учебную таблицу:
| Автоматизация | Владелец | Что проверить |
|---|---|---|
| Ежедневная сводка заявок | Не назначен | Кто получает и использует сводку |
| Напоминания об интервью | Продакт | Нет ли повторных сообщений |
| Черновик контент-плана | Редактор | Где происходит согласование |
Если хочешь помощь ИИ, передай обезличенную таблицу вместо полного JSON с конфигурацией:
Помоги составить план ревизии трёх учебных автоматизаций:
1. Ежедневная сводка заявок — владелец не назначен.
2. Напоминания об интервью — владелец продакт, возможны повторы.
3. Черновик контент-плана — владелец редактор, согласование не описано.
Дай для каждой один вопрос владельцу и один критерий готовности.
Не утверждай, что процессы работают или неисправны: данных о запусках нет.
6. Закрой пробное подключение
После проверки удали ненужный тестовый ключ или оставь его только для согласованной регулярной ревизии с владельцем и сроком действия. Зафиксируй результат: подключение работает, список сверили, изменения в автоматизации не вносили — но только если ты действительно выполнил эти шаги.
Моя рекомендация: первая задача для API n8n — маленькая инвентаризация. Она помогает освоить доступ и увидеть границы данных до автоматизации массовых изменений.
Для следующего шага пригодятся разбор данных между нодами и контент-процесс с проверкой редактора.
Проверка материала: документация сверена 9 октября 2026 года. Создание ключа и запрос к реальному экземпляру n8n в рамках подготовки статьи не выполнялись; таблица учебная.
Сборку таких процессов изучаем на курсе по ИИ-агентам.
Собери своего ИИ-агента и проверь результат
«AI Agents: от vibe coding к AI-команде»: desktop agents, MCP, skills, evals и harness. Отдельные воркшопы — от подключения инструментов до контроля качества.
7 практических воркшопов · записи · вопросы автору в чате
Посмотреть программу курса ↗