Dropbox v2 -与list_folders的光标和分页混淆

Question

api文档中的file/list _folders方法用于描述游标参数：

-将光标传递到list_/继续查看自上一次查询以来文件夹中发生了哪些更改。

has_more -如果是真的，那么还有更多的条目可用。将光标传递给list_folder/继续检索其余部分。

文件夹

那是哪一种？如果我向传递令牌的list_folders_continue发出另一个请求，我是在请求另一页结果或对文件夹的更改吗？如果我要求另一页的结果，有什么限制是适用的？我能控制住吗？

文档中的list_folder方法也位于共享下，该方法似乎具有更精确的游标定义和对极限参数文件夹的支持。

文件下的方法也会有这种情况吗？

Answer 1

那是哪一种？如果我向传递令牌的list_folders_continue发出另一个请求，我是在请求另一页结果或对文件夹的更改吗？

两者都是。文件/列表_文件夹/继续端点既用于返回附加的项页，也用于获取将来的进一步更新。

文件/列表_文件夹/继续返回的每一页在大小上都是有限的，但没有保证的限制，也无法控制该限制。您的应用程序应该始终检查has_more并调用/ true /list_folder/ check (如果是true)。

另外，端点文件夹和文件夹是具有不同功能的不同端点。

文件/列表_文件夹端点记录如下：

返回文件夹的内容。

共享/列表_文件夹端点记录为：

返回当前用户可以访问的所有共享文件夹的列表。

这两个端点使用不同的游标，分别用于文件夹/继续和文件夹/继续。

Answer 2

那是哪一种？如果我向传递令牌的list_folders_continue发出另一个请求，我是在请求另一页结果或对文件夹的更改吗？如果我要求另一页的结果，有什么限制是适用的？我能控制住吗？

我自己的试验和错误实验已经确定，格雷格发布的“两者都是”的答案是不正确的。确切地说，正确的答案是“要么是”。有关更多细节，请参见下面。

当调用files/list_folder并返回整个内容列表( has_more值为false)时，返回的游标适合于监视通过将游标传递给files/list_folder/continue而指定的路径的后续更改。

如果files/list_folder返回多个内容页中的第一个( has_more值为true)，则返回的游标适合于通过将其传递给files/list_folder/continue来获取下一页内容。此游标不适合监视更改(您可以自己尝试，您可以使用该游标多次调用“继续”，并且始终会得到第二页的内容)。

从文档中还不完全清楚，但是当从files/list_folder/continue获取内容页时，每个调用都将返回一个新的游标，并且必须将新的游标传递给后续的files/list_folder/continue调用，以获得下一个页面。您必须以这种方式将游标链接在一起，直到得到最后一页(其中has_more是false)。

在最后一次对files/list_folder/continue的调用中返回的游标随后可以用于对files/list_folder/continue的调用，以监视对files/list_folder的第一次调用中指定的原始路径的更改。

因此，游标要么适合监视更改(当它以has_more值false返回时)，要么适合于获取后续的内容页(当它以has_more值true返回时)，而不管产生游标的调用是files/list_folder还是files/list_folder/continue，但从来都不是两者兼而有之。