分页

游标

列表接受 ?limit= 和 ?cursor=，并在数据旁返回一个 meta 对象：

GET /v1/events?limit=2

{
  "events": [
    {
      "v": 1,
      "t": "tweet.create",
      "op": "create",
      "id": "tweet:2097879002992070835",
      "…": "…"
    },
    {
      "v": 1,
      "t": "follow.add",
      "…": "…"
    }
  ],
  "meta": {
    "count": 2,
    "has_more": true,
    "next_cursor": "eyJpZCI6MTAxODMyLCJ0IjoiMjAyNi0wOS0xNlQwODo0MDoxMSswMDowMCJ9"
  }
}

把 next_cursor 作为 ?cursor= 回传以获取下一页；null 表示到底了。游标是不透明的，并随其指向的数据一起过期。事件按最新在前排序，监控目标按字母排序。读取一节下的关注列表和时间线读取以同样方式使用 X 自己的游标，那里的 count 只是提示而非承诺——页大小由 X 决定，它经常忽略较小的值，所以请求 5 条可能返回 70 条。