微服务中的 REST API 方法路径命名

Question

有一项服务将为客户提供服务的注册功能。其中一种方法将提供用户提交的所有应用程序的列表。从以下选项中，应该是 OR 是基于 REST 和微服务原则的这种方法的 更好 uri/path。

1. /users/{id}/enrollments
2. /users/{id}/enrollments/list
3. /api/enrollments/submitter-id/{id}
4. /enrollments/{id}/list

Answer 1

要回答这个问题，可能需要更多信息，例如对体系结构的高度概述，它可以说明您为系统确定的资源是什么。 现在，对 url 形成背后的基本理解是围绕资源 https://en.wikipedia.org/wiki/Resource-oriented_architecture 形成它。

例如：假设您正在构建用户尝试注册课程的 restfull api。这里的资源可以是课程、主题、课程等。 现在要获取提供的主题列表，一个 url 可以看起来像

GET /topics -> gets all the topics.
GET /topics/{id} -> gets specific topic.
POST /topics -> creates new topic.
PUT /topic/{id} -> updates a particular topic.

希望对你有帮助