Paginierung
Cursor
Listen nehmen ?limit= und ?cursor= entgegen und antworten mit einem meta-Objekt neben den Daten:
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"
}
}Geben Sie next_cursor als ?cursor= zurück, um die folgende Seite zu erhalten; null bedeutet das Ende. Cursor sind opak und laufen mit den Daten ab, auf die sie zeigen. Neueste zuerst bei Ereignissen, alphabetisch bei Zielen. Die Folgt-Listen- und Timeline-Lesezugriffe unter Lesezugriffe verwenden die eigenen Cursor von X auf dieselbe Weise, und dort ist count ein Hinweis, kein Versprechen – X bestimmt die Seitengröße und ignoriert kleine Werte regelmäßig, sodass eine Anfrage nach 5 auch 70 liefern kann.