Рукописная n8n-нода — это почти гарантированный долг и рассинхрон. API меняется, а код, дока и CLI живут уже в разных версиях. В итоге на проде ловят странные ошибки: в документации поле есть, в ноде его нет, а в SDK оно называется уже иначе.
Хороший разбор показал, как эту схему ломают правильно. Ноду перестроили не руками, а генерацией из одного OpenAPI/TSP-файла. Из него же собираются документация, SDK и сама нода. Один коммит — и изменения расходятся по всем артефактам автоматически. CI ещё и публикует всё по реестрам, так что «забыли обновить ноду» тут больше не работает 🔧
Самый жёсткий вывод: первую ручную версию просто выбросили. Потому что поддерживать два источника правды — это не инженерия, а источник инцидентов. Если у вас вебхук, SDK или интеграция с внешним API, синхронизация через генерацию обычно дешевле и надёжнее, чем вечный ручной патчинг.
Host & DNS
@HostDnsPro
Рукописная n8n-нода — это почти гарантированный долг и рассинхрон. API меняется, а код, дока и CLI живут уже в
Этот пост опубликован в Telegram-канале Host & DNS. Подписаться можно по ссылке: @HostDnsPro.