verified by n8n: Как мы сгенерировали ноду из OpenAPI и почему пришлось выбросить рукописную версию

Вот важная новость с фронта ИИ: lookinway 47 минут назад verified by n8n: Как мы сгенерировали ноду из OpenAPI и почему пришлось выбросить рукописную версию Средний 11 мин 2. 5K Искусственный интеллект Программирование * Визуальное программирование * Open source * Веб-разработка * Кейс Привет, Хабр! Меня зовут Андрей и я развиваю портал для разработчиков в корпоративном мессенджере Пачка.

Эта статья про то, как мы превратили рукописную ноду для n8n в артефакт, который генерируется из одного файла спецификации, и как она прошла официальную верификацию и встала в каталог n8n со статусом verified by n8n. По дороге мы выбросили целиком первую версию ноды и перевели всю документацию API на новый процесс генерации. Ниже — как это устроено внутри, с кодом и граблями.

Технические детали

Если коротко, что получилось: правка в одном . tsp-файле автоматически расходится в документацию, CLI, SDK и n8n-ноду, а CI публикует всё по реестрам. Нода больше не может отстать от API, потому что собирается из того же источника.

Точка отсчёта: документация без единого источникаПубличная документация API Пачки существует с 2020 года. Технически это был отдельный самописный сайт на рукописных HTML и JS. Каждый эндпоинт описывался HTML-таблицей вручную.

Единого машиночитаемого источника, например OpenAPI, не было. Со временем справочника перестало хватать. API рос, у разработчиков появлялись запросы на SDK под разные языки, кто-то собирал свои сторонние библиотеки под Пачку сам.

Отраслевые последствия

Но из рукописных HTML-таблиц ничего не сгенерируешь: как источник для кодогенерации они бесполезны. Нам нужен был один машиночитаемый контракт, из которого можно собирать и документацию, и SDK. Источником правды должна стать спецификация, а всё остальное — производным от неё.

Зачем нам вообще n8nn8n — open-source платформа для no-code-автоматизаций: визуальный редактор, сотни готовых нод, события и действия соединяются мышкой. Мы заметили, что ей уже пользуются наши клиенты, многие разворачивают её на собственном сервере. Для продукта с открытым API это очевидный канал: дать пользователям силу API без единой строчки кода, чтобы собрать бота, согласование по кнопкам, выгрузку задач во внешние сервисы.

Отдельно подкупает, что готовый сценарий в n8n — это просто JSON: им можно поделиться и импортировать в пару кликов, а собрать его теперь способен и ИИ — он знает ноды и выдаёт рабочий workflow. И всё крутится внутри n8n, без отдельного хостинга под каждую интеграцию. Чтобы Пачка нормально жила внутри n8n, ей нужна своя нода.

Этот прогресс даёт важные сигналы о будущем отрасли, и технологический мир внимательно наблюдает.