TGViewer
Системный анализ | Ольга Пономарева Системный анализ | Ольга Пономарева @system_analyse · 31.5K subscribers
Post #5148 2.29K
Внутренним API тоже нужна обратная совместимость?

Буквально недавно перед одним из наших экспертов стояла задача доработать метод API таким образом, что он потерял обратную совместимость со своей прежним видом (добавили path параметр)

С одной стороны всё просто: API принадлежит одной команде, можно быстро договориться, а при необходимости одновременно обновить фронты и бэки

Но ситуация была неоднозначная

🟢 Позиция «Выкатим все одновременно и нормально»
Внутренние API не обязаны жить вечно. Если контракт используется несколькими сервисами одной команды, можно синхронно внести изменения, быстро обновить потребителей и удалить старую версию.
Полная обратная совместимость здесь может только замедлять развитие: появляются лишние версии, временные поля и поддержка устаревших сценариев


🔴 Позиция «правила должны быть как для внешних, так и для внутренних API»
Внутренний API это тоже контракт. Про некоторых потребителей мы могли забыть, команды меняются, зависимости не всегда очевидны, а синхронное обновление всех сервисов часто невозможно.
Это проблема особенно если сервисы разворачиваются независимо и если нашли баги в одном и откатываем релиз, то и второй сервис тоже должны откатить. Поэтому нужны версионирование, правила изменения контрактов и период миграции


А как у вас: внутренний API можно менять свободнее или обратная совместимость должна быть обязательным правилом для всех интеграций?
  • ❤ 4
More from @system_analyse
  1. Sep 21, 2026Пишите сопроводительные через ИИ? Мы решили провести эксперимент и проверить, что из этого…
  2. Sep 18, 2026Есть сервис поиска товаров в интернет-магазине. При запуске системы было определено НФТ: В…
  3. Sep 17, 2026Давайте пока сделаем как быстрее, а к архитектуре вернёмся потом Знакомо? Только это «пото…
  4. Sep 15, 2026Любимая ситуация аналитика: технически всё работает, а по факту нет 🌚 Kafka не упала. Соо…
  5. Sep 14, 20261 сентября мы немного намекнули, что планируем новый формат про поиск работы и подготовку…
  6. Sep 14, 2026Post #5139
Threads Profile ViewerView any public Threads profile without an account.Open ThreadLook →Writing with AI? Make it sound human.Metric37 rewrites AI drafts so they read naturally. Free AI detector, 1,500 words free.Try Metric37 →