Skip to main content
Die Trassets Data API nutzt zwei Pagination-Strategien, abhängig vom Endpunkt-Typ. Category-Endpunkte unterstützen Offset-basierte Pagination, die für Dashboards und inkrementelle Abrufe einfach und vorhersehbar ist. Raw-Endpunkte nutzen Cursor-basierte Pagination, die auch dann stabil bleibt, wenn sich die zugrunde liegenden Daten während eines Bulk-Exports ändern.

​
Pagination für Category-Endpunkte

Category-Endpunkte akzeptieren die Query-Parameter limit und offset. Die API liefert Pagination-Metadaten in Response-Headern, sodass du Links zur nächsten und vorherigen Seite bauen kannst, ohne den Response-Body zu parsen.
​
integer
Gesamtzahl der Zeilen, die der Query entsprechen, unabhängig von limit und offset.
​
string
"true" oder "false" — gibt an, ob über die aktuelle Seite hinaus weitere Zeilen existieren.
​
integer
Der Offset für die nächste Seite. Nur vorhanden, wenn X-Has-More gleich "true" ist.
​
string
Ein undurchsichtiger Cursor für die nächste Seite. Nur vorhanden, wenn eine vollständige Seite zurückgegeben wurde. Du kannst diesen anstelle von offset als cursor-Query-Parameter im nächsten Request übergeben.
Dieses Beispiel ruft Seite 2 mit einem Offset von 100 ab:

​
Pagination für Raw-Endpunkte

Raw-Endpunkte nutzen Cursor-basierte Pagination über den Query-Parameter cursor. Der Cursor-Wert stammt aus dem next_cursor-Feld im Response-Body. Cursor sind stabil gegenüber gleichzeitigen Schreibvorgängen, sodass Zeilen, die während eines Bulk-Exports hinzugefügt oder entfernt werden, keine Duplikate oder Lücken verursachen. Der Response-Body enthält diese Felder:
​
array
Das Array der Zeilen für die aktuelle Seite.
​
integer
Anzahl der Zeilen auf der aktuellen Seite.
​
string | null
Der Cursor, der für die nächste Seite übergeben werden soll. Wenn null, wurden alle Zeilen abgerufen.
​
integer
Gesamtzahl der Zeilen in der Tabelle.
Die Antwort enthält außerdem einen X-Snapshot-At-Header mit dem ISO-8601-Zeitstempel des letzten erfolgreichen Syncs für diese Tabelle. Dieses Beispiel ruft die erste Seite ab und nutzt dann den Cursor, um fortzufahren:
Wenn next_cursor null ist, ist der Export abgeschlossen.
Der maximale Offset für Category-Endpunkte beträgt 500.000. Wenn du mehr Zeilen exportieren musst, als das erlaubt, wechsle zu einem Raw-Endpunkt oder wende Filter an, um die Ergebnismenge zu reduzieren.