小编典典

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

all

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

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

目前,我向如下 URL 结构发出请求:

  • /api/members - 返回成员列表(如上所述,一次 30 个)
  • /api/members/1 - 影响单个成员,取决于使用的请求方法

我的问题是:我将如何使用类似的 URL 结构来获取我的应用程序中的成员总数?显然,仅请求该id字段(类似于 Facebook 的 Graph
API)并计算结果将是无效的,因为只会返回 30 个结果的一部分。


阅读 112

收藏
2022-08-07

共1个答案

小编典典

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

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

2022-08-07