Рукописные интеграции — это не «быстрее старт», а долг по репутации продукта.
Пока API живёт отдельно, а n8n-нода отдельно, вы гарантированно получаете рассинхрон: документация врёт, поддержка тушит чужие баги, пользователи ломаются на пустом месте. И каждый такой косяк бьёт не только по dev experience, но и по доверию к бренду.
В этом кейсе сделали правильно и жёстко: один .tsp-файл как источник правды, из него собираются документация, CLI, SDK и сама нода. В итоге первую рукописную версию просто выбросили. Без жалости. Потому что держать живой отдельный артефакт ради «контроля» — это иллюзия контроля.
Что здесь важно для нас, не только для разработчиков:
1) меньше ручных расхождений → меньше публичных инцидентов;
2) проще держать обещания в коммуникации;
3) быстрее отвечать на вопросы рынка, потому что ответ один и он совпадает с продуктом.
Мой вывод простой: если у вас интеграции живут отдельно от API, у вас уже есть будущий кризис. Просто пока без заголовка в медиа.
Crisis Room
@CrisisRoomPro
Рукописные интеграции — это не «быстрее старт», а долг по репутации продукта.
Этот пост опубликован в Telegram-канале Crisis Room. Подписаться можно по ссылке: @CrisisRoomPro.