Paginering

Cursors

Lijsten accepteren ?limit= en ?cursor= en antwoorden met een meta-object naast de gegevens:

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

Geef next_cursor terug als ?cursor= voor de volgende pagina; null betekent het einde. Cursors zijn ondoorzichtig en verlopen samen met de gegevens waarnaar ze verwijzen. Nieuwste eerst voor gebeurtenissen, alfabetisch voor targets. De volglijst- en tijdlijnleesbewerkingen onder Leesbewerkingen gebruiken de eigen cursors van X op dezelfde manier, en daar is count een hint, geen belofte — X bepaalt de paginagrootte en negeert kleine waarden routinematig, dus een verzoek om 5 kan er 70 opleveren.