Совместимость и версии API: старые клиенты и дифф спецификации

Тимур · бэкенд, #qa-antrakt

Пока есть месяц, хочу навести порядок. У «ПлатиМ» сумма теперь amount_minor, а у нас в заказе total, и все путаются, рубли там или копейки. Переименую в total_minor. Ника, поправишь веб в тот же день? PR маленький.

Ника · фронтенд, #qa-antrakt

Веб поправлю, выкатим вместе.

Вера Ланская · лид QA, #qa-antrakt

А приложение в сторах кто поправит? Его обновляют не все и не сразу: на прошлой неделе с версиями полугодовой давности к нам пришла треть заказов. Тимур, твой PR маленький, а сломает он каждого третьего зрителя в ночь продаж.

В уроке 88 мы стояли на месте потребителя: «ПлатиМ» менял формат, и мы проверяли, касается ли это нас. Теперь роли меняются. Провайдер это «Антракт», а потребители это наши собственные клиенты: веб, мобильное приложение, партнёры, которые продают наши билеты у себя. И у некоторых из них нет Ники, которая поправит всё в тот же день.

Новый замок в подъезде

Управляющая компания решила поменять замок в подъезде на более надёжный. Замок поставили утром, ключи раздали тем, кто был дома. Вечером половина жильцов стоит у двери со старыми ключами. Кто-то в отпуске, кто-то не видел объявление, у бабушки с пятого этажа ключ вообще один, на цепочке.

Нормальная управляющая компания делает иначе. Сначала ставит замок, который открывается и старым ключом, и новым. Месяц раздаёт новые ключи и смотрит, сколько людей ещё ходит со старыми. И только когда старым ключом неделю никто не пользуется, меняет личинку окончательно.

Обратная совместимость это ровно такой замок. Старый клиент со старым ключом должен открывать дверь новой версии API.