Комментарии 3
Только пользы от предложенной метрики "зрелости" апи нету.
Во первых, то что там происходит в url не важно, во вторых введение "ресурсов" в текущем виде похоже на моделирование через CRUD, что хорошо далеко не всегда, а подаётся как обновление ради обновления.
И да, версионирование апи — вынужденная неприятность.
Приведенный пример улучшения апи не является единственно возможным и он не на все случаи жизни.
Предложенные в статье метрики были установлены исходя из наших целей улучшения апи:
* Ускорение процесса клиентской и серверной̆ разработки;
* Снижение временных затрат на поддержку и развитие API;
* Добавление автогенерации документации API;
* Поддержка версионности API для упрощения поддержки обратной совместимости с помощью версионности API.
Если вы преследуете другие цели, то возможно у вас будут другие метрики, будет очень интересно, если вы ими поделитесь!
Версионирование действительно необходимо не каждому апи, но если есть понимание, что с верисями будет работать удобнее, то перечисленные способы и пример реализации в статье могут вам помочь.
Предложенные в статье метрики были установлены исходя из наших целей улучшения апи:
* Ускорение процесса клиентской и серверной̆ разработки;
* Снижение временных затрат на поддержку и развитие API;
* Добавление автогенерации документации API;
* Поддержка версионности API для упрощения поддержки обратной совместимости с помощью версионности API.
Если вы преследуете другие цели, то возможно у вас будут другие метрики, будет очень интересно, если вы ими поделитесь!
Версионирование действительно необходимо не каждому апи, но если есть понимание, что с верисями будет работать удобнее, то перечисленные способы и пример реализации в статье могут вам помочь.
спасибо, отличная статья, сейчас как раз запилю версионирование Rest Api по вашему примеру на заголовке
Зарегистрируйтесь на Хабре, чтобы оставить комментарий
Делаем новую версию API. Быстро и легко