RESTful API设计中的分页问题

Question

我正在为正在开发的移动应用程序设计RESTful API。我的问题是包含许多项目的大型集合。我知道一个好的做法是在集合中对大量结果分页。

我已经阅读了Facebook Graph API文档(https://developers.facebook.com/docs/graph-api/using-graph-api/v2.2)，推特光标文档(https://dev.twitter.com/overview/api/cursoring)，GitHub API文档(https://developer.github.com/v3/)以及本文（API分页最佳实践）。

考虑我的API中的一个示例集合，该集合包含100个名为resource1到resource100并按降序排序的项。这是您将在get请求时得到的响应（gethttp://api.path.com/resources?limit=5）：

{
    "_links": {
        "self": { "href": "/resources?limit=5&page=1" },
        "last": { "href": "/resources?limit=5&page=7" },
        "next": { "href": "/resources?limit=5&page=2" }
    },

    "_embedded": {
        "records": [ 
            { resource 100 },
            { resource 99 },
            { resource 98 },
            { resource 97 },
            { resource 96 }
        ]
    }
}

现在我的问题是这样一个场景：

1-我GET/资源具有上述内容。

2-之后，资源集合中添加了一些内容（例如，另一个设备为该帐户添加了新资源）。现在我有101个资源。

3-我GET/资源？限制=5

{
    "_links": {
        "self": { "href": "/history?page=2&limit=5" },
        "last": { "href": "/history?page=7&limit=5" },
        "next": { "href": "/history?page=3&limit=5" }
    },

    "_embedded": {
        "records": [ 
            { resource 96 },
            { resource 95 },
            { resource 94 },
            { resource 93 },
            { resource 92 }
        ]
    }
}

如您所见，资源96在两个页面中重复出现（或者，如果在步骤2中删除了一个资源，则可能会发生类似的问题，在这种情况下，将丢失一个资源）。

因为我想在一个移动应用程序和一个列表中使用它，所以我必须将每个API调用的资源附加到它之前的那个API调用，这样我才能有一个完整的列表。但这令人担忧。如果你有什么建议，请告诉我。提前谢谢你。

P、 S：我考虑过类似时间戳的查询字符串，而不是基于光标的分页，但这会在其他地方给我带来问题。（如果您需要更多信息，请告诉我。）




Answer 1

为什么不维护一组可见的资源？

然后，在处理每个响应时，可以检查资源是否已经呈现。

Answer 2

我们刚刚通过REST API为移动应用程序实现了类似的功能。移动应用程序传递了一个额外的查询参数，该参数表示页面中的元素“冻结”的时间戳。

所以您的第一个请求看起来像是获取/资源？限制=5

如果移动应用程序想要区分“软”页面（保留第1页请求的时间戳）和“硬刷新”页面（将时间戳重置为当前时间），那么它也可以进行控制。