Привет, коллеги! В последнее время у нас в проекте всё чаще всплывает одна и та же боль: API-контракты меняются быстрее, чем успевают обновляться клиенты и документация. Вроде и договариваемся на встречах, и пишем схемы, но стоит кому-то добавить поле или поменять формат ответа — и начинается цепочка «а я думал, что там строка». Хочется найти подход, который не превращается в бюрократию, но реально экономит нервы.
Я пробовал разные варианты: держать всё в одном репозитории, генерировать клиентов из спецификации, проверять контракты в CI. Что-то работает, что-то отваливается, когда команда растёт или появляется срочный хотфикс. Пока не могу понять, где золотая середина между строгостью и скоростью разработки.
Как у вас организован процесс? Вы пишете API-контракты до кода, после кода или вообще живёте без формальных схем? И что помогает ловить рассинхрон раньше, чем он уедет в прод? Буду рад любым историям и граблям.
Я пробовал разные варианты: держать всё в одном репозитории, генерировать клиентов из спецификации, проверять контракты в CI. Что-то работает, что-то отваливается, когда команда растёт или появляется срочный хотфикс. Пока не могу понять, где золотая середина между строгостью и скоростью разработки.
Как у вас организован процесс? Вы пишете API-контракты до кода, после кода или вообще живёте без формальных схем? И что помогает ловить рассинхрон раньше, чем он уедет в прод? Буду рад любым историям и граблям.