微服务路径 /api/v1/ 或 /v1/api/ [关闭]答案

【问题标题】：MicroService path /api/v1/ or /v1/api/ [closed]微服务路径 /api/v1/ 或 /v1/api/ [关闭]
【发布时间】：2017-11-15 14:12:46
【问题描述】：

我正在构建一个 MicroServive，并计划使用此 URI 命名约定发布服务：

https://host:port/api/v1/service1
https://host:port/api/v1/service2
https://host:port/api/v2/service1
https://host:port/api/v2/service2

但我也见过这样命名的 URI（即 vx 和 api '交换'）：

https://host:port/v1/api/service1
https://host:port/v1/api/service2
https://host:port/v2/api/service1
https://host:port/v2/api/service2

在我看来，第一种方法更好。有什么理由选择第二种方法吗？

【问题讨论】：

【解决方案1】：

技术上没关系

但在整体 REST 方法中，URL 应该易于人类阅读和理解。

使用您的第一种方法是正确的形式，因为它易于阅读

The Api of Version 1 that exposes ...

【讨论】：