Приведенный пример улучшения апи не является единственно возможным и он не на все случаи жизни.
Предложенные в статье метрики были установлены исходя из наших целей улучшения апи:
* Ускорение процесса клиентской и серверной̆ разработки;
* Снижение временных затрат на поддержку и развитие API;
* Добавление автогенерации документации API;
* Поддержка версионности API для упрощения поддержки обратной совместимости с помощью версионности API.
Если вы преследуете другие цели, то возможно у вас будут другие метрики, будет очень интересно, если вы ими поделитесь!
Версионирование действительно необходимо не каждому апи, но если есть понимание, что с верисями будет работать удобнее, то перечисленные способы и пример реализации в статье могут вам помочь.
Предложенные в статье метрики были установлены исходя из наших целей улучшения апи:
* Ускорение процесса клиентской и серверной̆ разработки;
* Снижение временных затрат на поддержку и развитие API;
* Добавление автогенерации документации API;
* Поддержка версионности API для упрощения поддержки обратной совместимости с помощью версионности API.
Если вы преследуете другие цели, то возможно у вас будут другие метрики, будет очень интересно, если вы ими поделитесь!
Версионирование действительно необходимо не каждому апи, но если есть понимание, что с верисями будет работать удобнее, то перечисленные способы и пример реализации в статье могут вам помочь.