Катим в прод | Александр Калыргин
31.01
⚡️ Подходы к версионированию API
Секция: Интеграции/HTTP/REST 👣 Востребованность на собесе: Периодически ⭐️
Версионирование API — важный аспект разработки, позволяющий управлять изменениями и поддерживать совместимость 🔄
Рассмотрим основные подходы:
1️⃣ Версия в параметрах запроса (Query-параметры) Указывается в строке запроса. GET https://petshop.ru/api/resource?version=1.0
2️⃣ Версия в URI Включается в адрес запроса. GET https://petshop.ru/v1/resource
3️⃣ Версия в заголовках (Headers) Передаётся через HTTP заголовки. Version: 1.0
4️⃣ Версия в теле запроса (Body) Передаётся как часть данных. { "version": "1.0", "data": { "key": "value" } }
⚡️ При изменении API
— Минимизируйте влияние изменений на существующие интеграции. — Поддерживайте обратную совместимость. — Уведомляйте клиентов о грядущих изменениях. — Ведите документацию для каждой версии API. — Отслеживайте использование устаревших версий.
Какой способ используете вы? Делитесь в комментариях! ⬇️
Николай Колесник
· 01.02
Самое главное-то не рассказали. Все пункты основаны на самом популярном паттерне версионирования - семантической строке. В этой строке обычно три числа, первое отвечает за мажорные версии, которые обновляются при накате обратно не совместимых изменений, второе число (минорная версия) отвечает за накат новой обратно совместимой функциональности, а третье число, которое часто не используют - это патчи, то есть обратно совместимые изменения с устранением ошибки или корректировкой поведения работы API.
ответить
Александр Калыргин
01.02
Кстати да, хорошее замечание)
ответить
еще контент в этом сообществе
еще контент в этом соообществе
Катим в прод | Александр Калыргин
31.01
войдите, чтобы увидеть
и подписаться на интересных профи