Asp.Net Core REST API 分层数据结构

Question

我有一个关于如何构建我的控制器的问题。 假设我有一个系统，其中包含商店和产品，商店也有产品。

所以获取商店的方式是 /api/stores/{id}，获取产品的方式是 /api/product/{id} 或 /api/stores/{id}/product/{id}。

您将如何构建控制器？我应该有一个用于产品的控制器和一个用于商店的控制器，并且以其中的商店开头的每条路由都应该驻留在 StoresController 中，否则在 ProductsController 中？

Answer 1

这是来自 Microsoft：Api design guidance

在更复杂的系统中，提供 URI 以使客户端能够浏览多个级别的关系可能很诱人，例如 /customers/1/orders/99/products。然而，如果资源之间的关系在未来发生变化，这种复杂程度可能难以维持并且不灵活。相反，尽量保持 URI 相对简单。一旦应用程序引用了资源，就应该可以使用该引用来查找与该资源相关的项目。前面的查询可以替换为URI /customers/1/orders 来查找客户1 的所有订单，然后/orders/99/products 来查找此订单中的产品。