Версионирование API. Обратная совместимость в API
Description
Работаете с задачами на Backend, проектируете методы REST API или описываете интеграции? Этот эпизод актуален для вас. В нём мы разберём, что такое версионирование API, когда и почему нужно вводить новые версии, какие подходы к версионированию лучше использовать и как это влияет на его пользователей.
Эпизод будет полезен системным аналитикам, которые работают с интеграциями, разрабатывают контракты методов API и сталкиваются с задачами изменения существующих API. Особенно это актуально в задачах на проектирование REST API методов.
Сообщество системных аналитиков GetAnalyst: t.me/getanalysts
Сайт эпизода: https://getanalyst.ru/podcast/api-versioning
00:19 - Знакомство со спикером и актуальность темы версионирования API.
03:05 - Что включает понятие версионирования API. Обратная совместимость в API.
7:55 - Сколько версий API могут работать одновременно.
8:59 - Как долго занимает переход с одной версии API на другую. Как правильно выводить из эксплуатации устаревшие версии API.
11:51 - Разработка контрактов REST API системными аналитиками: OpenAPI, Swagger, GitHub, Postman, Confluence.
14:51 - Проблемы тестирования и инфраструктуры при наличии нескольких активных версий API. Информирование клиентов об изменениях в API.
20:20 - Реализация версий в API и что об этом надо знать системному аналитику. Где указывать версию и в каком формате.
30:20 - Переход клиентских приложений на новые версии API. Проблемы и решения.
41:15 - Как отслеживать количество пользователей, использующих устаревшие версии API.
44:46 - Итоги эпизода и практические рекомендации.
Ведущая:
Екатерина Ананьева
Гости:
Елизавета Акманова,
Старший системный аналитик в компании UseTech