페이지네이션

커서

목록은 ?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개가 돌아올 수 있습니다.