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.