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

Question

关闭。这个问题是 opinion-based 。目前不接受答案。

---

想要改进这个问题吗？更新问题，以便 editing this post 可以用事实和引文来回答它。 .

已关闭 5 年前。

Improve this question

我正在构建一个 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

我认为第一种方法更好。有什么理由选择第二种方法吗？

Answer 1

从技术上讲，这并不重要

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

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

The Api of Version 1 that exposes ...