rest - 设计用于返回多个对象计数的 REST API

Question

鉴于我需要返回我的应用程序中不同对象的计数，我有一个关于我应该如何设计我的休息 api 的问题。有多种方法可以考虑

1. 定义一个 api，它通常接受请求正文 (json) 中的对象标识符，并返回响应中每个对象标识符的计数。缺点是 api 过于通用，并且可能因为没有资源而不稳定。该网址看起来像 GET/counts

2. 为需要计数的每个资源定义单独的 API。假设我需要返回软件、表格、流程、任务、作业等中定义的字段的计数，我将为这些资源中的每一个定义单独的 api。它看起来像 GET/field/count 或 GET/table/count。这样做的一个副作用是，对于我们需要计数的每个资源，都会有许多 Web API。那很糟糕吗？

请分享您对上述方法的想法，以及我可以用来设计符合 REST 标准的 API 的任何新方法。

谢谢

Answer 1

这完全取决于使用 API 的客户端。

案例 1。如果它是一个需要在单个页面上计算许多表的 WebApp，那么两者都会导致糟糕的设计，您将不得不为计数数据进行数百次调用。您可以在单个 API 中合并计数并将其作为响应发送。

案例 2。如果客户单独使用计数，那么我会推荐第二种方法，其中明确定义了资源。对于第二种方法，您正在使客户端变得智能，这是不推荐的。

如评论中所述，REST 是一个完全主观的主题，因此每个设计都可以有多个观点。