Сообщить об ошибкеКороткий ответ
Версионирование API позволяет вносить несовместимые изменения в новой версии, не ломая клиентов, которые продолжают использовать старую версию, пока не перейдут на новую.
Как это работает подробнее
Старая и новая версии эндпоинтов существуют параллельно (/v1/orders и /v2/orders) какое-то время, после чего старую версию выводят из эксплуатации по согласованному графику.
Что использовать на практике
- Практика. Версионируют через префикс URL, заголовок или параметр запроса; важно явно сообщать о депрекации и сроках отключения старой версии.
Подводные камни
- Риск. Вносить breaking change в существующую версию «по-тихому» без новой версии; держать старые версии вечно без плана вывода.