Ответ.

Версионирование API (Application Programming Interface) помогает развивать интерфейсы и обеспечивать обратную совместимость при изменениях, чтобы внешние и внутренние клиенты не ломались при каждом обновлении.

Основные схемы версионирования:

• URL-версионирование: /api/v1/resource.
• Версионирование через заголовок: Accept: application/vnd.company.v1+json.
• Версионирование через параметры запроса: /api/resource?version=2.

Обычно используют подход с версией в URL, так как он ясен и прозрачен для всех клиентов.

Пример на Node.js (Express):

// Версия 1
app.get('/api/v1/orders', ordersV1Handler);
// Версия 2
app.get('/api/v2/orders', ordersV2Handler);

Ключевые особенности:

• Позволяет развивать продукт без риска для пользователей старых клиентов.
• Обеспечивает плавный переход между поколениями API.
• Обязателен для крупных корпоративных и публичных систем.

Вопросы с подвохом.

Достаточно ли всегда поддерживать только последнюю версию API?

Нет, пользователи старых приложений могут не иметь возможности срочно перейти на новый интерфейс, поэтому часто поддерживают несколько актуальных версий.

Можно ли добавить обратно несовместимые изменения в минорной версии API?

Нет, минорные версии должны быть строго совместимы с предыдущими. Breaking changes требуют смены мажорной версии.

Влияет ли способ версионирования (URL, заголовки, параметры) на безопасность или производительность API?

Нет, само по себе место хранения версии не влияет на технические характеристики, но URL-версионирование проще анализировать средствами мониторинга и поддержки.