微服务路径 /api/v1/ 或 /v1/api/

Question

我正在构建一个 MicroSerive，我正计划使用此 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 'swapped'）：

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

在我看来，第一种方法更好。是否有理由采用第二种方法？

Answer 1

技术上没关系

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

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

The Api of Version 1 that exposes ...

MicroService path /api/v1/ or /v1/api/