ページネーション

カーソル

一覧系は ?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 件返ることがあります。