rest - 返回对象中项目总数的最佳 RESTful 方法是什么？

Question

我正在为我参与的大型社交网站开发 REST API 服务。到目前为止，它运行良好。我可以发出 GET , POST , PUT和 DELETE请求对象 URL 并影响我的数据。但是，此数据是分页的(一次限制为 30 个结果)。

但是，通过我的 API 获取成员总数的最佳 RESTful 方式是什么？

目前，我向 URL 结构发出请求，如下所示:

/api/members — 返回成员列表(如上所述，每次 30 个)

/api/members/1 — 影响单个成员，取决于使用的请求方法

我的问题是:我将如何使用类似的 URL 结构来获取我的应用程序中的成员总数？显然只要求 id字段(类似于 Facebook 的 Graph API)并且由于仅返回 30 个结果的切片，因此计算结果是无效的。

Answer 1

虽然对/API/users 的响应被分页并只返回 30 条记录，但没有什么可以阻止您在响应中包括记录总数和其他相关信息，如页面大小、页码/偏移量等.

StackOverflow API 是相同设计的一个很好的例子。这是用户方法的文档 - https://api.stackexchange.com/docs/users