Pagination

Curseurs

Les listes acceptent ?limit= et ?cursor= et répondent avec un objet meta à côté des données :

{
  "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"
  }
}

Renvoyez next_cursor en ?cursor= pour la page suivante ; null signifie la fin. Les curseurs sont opaques et expirent avec les données qu'ils désignent. Du plus récent au plus ancien pour les événements, par ordre alphabétique pour les cibles. Les lectures de listes d'abonnements et de fil sous Lectures utilisent les curseurs de X de la même manière, et là count est une indication, pas une promesse — X décide de la taille de page et ignore régulièrement les petites valeurs, si bien qu'une demande de 5 peut en renvoyer 70.