Pagination
Cursor-basierte Seitennavigation über große Ergebnismengen.
Listen-Endpunkte sind cursor-basiert paginiert. Jede Antwort enthaelt ein
page-Objekt mit dem Cursor der naechsten Seite.
Antwort-Form
{
"data": [ /* … Elemente … */ ],
"page": {
"nextCursor": "ZXZ0XzlwWA",
"hasMore": true
}
}| Feld | Bedeutung |
|---|---|
page.nextCursor | Cursor fuer die naechste Seite, oder null am Ende |
page.hasMore | true, solange weitere Seiten existieren |
Durch Seiten blaettern
Den nextCursor als Query-Parameter cursor an den naechsten Aufruf anhaengen:
# Erste Seite
curl "https://api.sandbox.example/v1/events?limit=25" \
-H "Authorization: Bearer pc_test_DEIN_SCHLUESSEL"
# Naechste Seite
curl "https://api.sandbox.example/v1/events?limit=25&cursor=ZXZ0XzlwWA" \
-H "Authorization: Bearer pc_test_DEIN_SCHLUESSEL"limitsteuert die Seitengroesse (1–100, Standard 25).- Solange
page.hasMoretrueist, mit dem jeweils neuennextCursorweiterblaettern.
Cursor sind undurchsichtig (opaque) und nur fuer den direkten Folgeaufruf gedacht — nicht parsen, nicht dauerhaft speichern. Keine Offset-/Seitenzahl-Pagination.