来自RESTful API的分页响应有效负载
我想在我的RESTful API中支持分页。 我的API方法应通过返回产品的JSON列表/products/index。但是,可能有成千上万种产品,我想分页浏览它们,因此我的请求应如下所示: /products/index?page_number=5&page_size=20 但是我的JSON响应需要什么样?API使用者通常会在响应中期望分页元数据吗?还是仅需要一系列产品?为什么? 看起来Twitter的API包含元数据:https://dev.twitter.com/docs/api/1/get/lists/members(请参阅示例请求)。 使用元数据: { "page_number": 5, "page_size": 20, "total_record_count": 521, "records": [ { "id": 1, "name": "Widget #1" }, { "id": 2, "name": "Widget #2" }, { "id": 3, "name": "Widget #3" } ] } 只是一系列产品(没有元数据): [ { "id": 1, "name": "Widget #1" }, { "id": …