Введение в версии API в Nest

Часть клиентов ещё ждёт прежний ответ, а новый интерфейс уже рассчитан на другой формат данных. Если поменять поведение для всех сразу, старые программы начнут ломаться без предупреждения.

Версионирование API позволяет держать несколько линий ответа параллельно. Клиент явно указывает, к какой линии он обращается, а сервер направляет запрос к нужному обработчику. В Nest 12 это включают встроенным механизмом: достаточно настроить приложение при старте и пометить контроллер или отдельный обработчик. Сторонние пакеты для этого не нужны.

Включение делают один раз при старте приложения NodeJS, а дальше метку версии можно закрепить за контроллером или за отдельным обработчиком. Клиент и сервер заранее договариваются, как передавать эту метку, а Nest направляет запрос к подходящему обработчику.