Twitter开发者账号无法申请【推特开发者文档系列5】——请求结果分页

本系列是对推特开发者文档进行的翻译,以便帮助开发人员使用API接口,难免有些地方存在不足,还请谅解。

关于如何获得一个推特开发者账号请看此贴:

推特开发者账号的申请

搜索微信公众号 twitterDeveloper 获得帮助


Cursoring(游标)

Twitter REST API利用一种称为“cursoring”的技术对大型结果集进行分页。游标将结果分隔成页面(页面大小由count请求参数定义),并提供在这些页面中前后移动的方法。

若要检索被标记的结果,首先要将值为-1的cursor传递到端口。默认情况下,如果不提供-1作为cusor的值,则支持游标的API端口将假定-1作为游标值传递。对被请求的响应将包含previous_cursornext_cursorprevious_cursor_strnext_cursor_str

伪代码

迭代来自游标端口的所有响应的伪代码为:
Twitter开发者账号无法申请【推特开发者文档系列5】——请求结果分页

例子

让我们看一个实际的游标例子。考虑一个常见的场景,在这个场景中,我们希望获得跟踪拥有大量关注者的用户的id列表。端口将返回结果页,而不是返回一个响应集中的所有id。
Twitter开发者账号无法申请【推特开发者文档系列5】——请求结果分页
Twitter开发者账号无法申请【推特开发者文档系列5】——请求结果分页
我们现在可以通过next_cursor获得新的数据。要获得下一批至少5000个结果,请执行相同的请求,但将 cursor设置为 next_cursor的值。
Twitter开发者账号无法申请【推特开发者文档系列5】——请求结果分页
Twitter开发者账号无法申请【推特开发者文档系列5】——请求结果分页
注意,我们现在有一个next_cursor和一个previous_cursor。这意味着我们现在可以在结果中前后移动。让我们继续用next_cursor在数据中前进。
Twitter开发者账号无法申请【推特开发者文档系列5】——请求结果分页
next_cursor现在是0,这表示不再有新的页。我们现在已经完成了对帐户关注者的迭代。