Twitter开发者账号无法申请【推特开发者文档系列5】——请求结果分页
本系列是对推特开发者文档进行的翻译,以便帮助开发人员使用API接口,难免有些地方存在不足,还请谅解。
关于如何获得一个推特开发者账号请看此贴:
推特开发者账号的申请
或
搜索微信公众号 twitterDeveloper 获得帮助
Cursoring(游标)
Twitter REST API利用一种称为“cursoring”的技术对大型结果集进行分页。游标将结果分隔成页面(页面大小由count请求参数定义),并提供在这些页面中前后移动的方法。
若要检索被标记的结果,首先要将值为-1的cursor
传递到端口。默认情况下,如果不提供-1作为cusor
的值,则支持游标的API端口将假定-1作为游标值传递。对被请求的响应将包含previous_cursor
、next_cursor
、previous_cursor_str
和next_cursor_str
。
伪代码
迭代来自游标端口的所有响应的伪代码为:
例子
让我们看一个实际的游标例子。考虑一个常见的场景,在这个场景中,我们希望获得跟踪拥有大量关注者的用户的id列表。端口将返回结果页,而不是返回一个响应集中的所有id。
我们现在可以通过next_cursor
获得新的数据。要获得下一批至少5000个结果,请执行相同的请求,但将 cursor
设置为 next_cursor
的值。
注意,我们现在有一个next_cursor
和一个previous_cursor
。这意味着我们现在可以在结果中前后移动。让我们继续用next_cursor
在数据中前进。next_cursor
现在是0,这表示不再有新的页。我们现在已经完成了对帐户关注者的迭代。