Paginación
Cursores
Las listas aceptan ?limit= y ?cursor= y responden con un objeto meta junto a los datos:
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"
}
}Devuelve next_cursor como ?cursor= para la página siguiente; null significa el final. Los cursores son opacos y caducan con los datos a los que apuntan. Los eventos van del más reciente al más antiguo; los objetivos, en orden alfabético. Las lecturas de listas de seguimiento y de cronología de Lecturas usan los cursores propios de X de la misma manera, y ahí count es una sugerencia, no una promesa — X decide el tamaño de página e ignora habitualmente los valores pequeños, así que una solicitud de 5 puede devolver 70.