REST API 设计和使用 Web 应用程序视图的多资源

Question

对于我正在开发的 web 应用程序，我正在编写一个 RESTful API，该 API 也计划用于该项目的移动版本，因此尝试应用最佳实践。

我知道每个不同类型的资源集合都有自己的 URI 点。例如，我有两个不同的资源及其 URI：

Products: https://api.myproject.com/products/
Users: https://api.myproject.com/users/

这是我的问题： 我的 webapp 的主页显示了前 40 个产品和最受欢迎的 10 个用户。在这种情况下，客户端通过 Ajax 连接以获取这些数据的最佳实践是什么？应该使用单个 API 点同时交付产品或用户，还是客户端连接到两个不同的 API 点以获取产品和用户。原因是我对此提出质疑，因为在 webapps 中最小化 HTTP 请求的数量是最佳做法。

谢谢

Answer 1

您的设计应取决于您对该 ReSTful 服务的要求。

如果性能是重中之重，那么您应该尝试有一个 API 联系人。然而，这种设计决策带来的性能提升是微乎其微的，而且性能更依赖于这些查询的后端实现。

但是，如果可修改性（易于编程和实现）对您来说更重要，那么请尝试使用 2 个单独的 API 点，您可以在其中灵活地为每个独特的实现选择用户、产品或任何实体的数量你的应用程序。通过使用这种设计而不是试图略微提高性能，您将在实施过程中节省大量时间。