Pagination

Damit die API schnell und reaktionsfähig bleibt, begrenzen Listen-Queries, wie viele Daten in einer einzelnen Anfrage zurückgegeben werden. In der API werden zwei Pagination-Arten verwendet:

• Cursorbasiert (aktuell): wird von neu entwickelten Listen-Queries verwendet.
• Offsetbasiert (Legacy): wird von den meisten bestehenden Listen-Queries verwendet. Diese werden irgendwann durch cursorbasierte Versionen ersetzt.

Cursorbasierte Pagination

Die cursorbasierte Pagination ist der aktuelle Standard. Mit ihr legen Sie den Startpunkt einer Anfrage über einen Cursor fest, eine eindeutige Kennung für eine Position in der Ergebnismenge.

Argumente

first · Integer

Die Anzahl der zurückzugebenden Elemente.

after · String

Der Cursor, ab dem begonnen wird. Lassen Sie dieses Argument weg oder setzen Sie es auf null, um die erste Seite abzurufen. Verwenden Sie für weitere Seiten den Wert page_info.end_cursor aus der vorherigen Antwort.

Antwort

Die Antwort liefert die Ergebnisse direkt über ein nodes-Array, zusammen mit Pagination-Metadaten.

nodes · Array

Die Liste der Datenobjekte für die aktuelle Seite.

total_count · Integer

Die Gesamtzahl der Elemente, die der Query entsprechen, über alle Seiten hinweg.

page_info.has_next_page · Boolean

Ob nach der aktuellen Seite weitere Ergebnisse verfügbar sind.

page_info.has_previous_page · Boolean

Ob vor der aktuellen Seite weitere Ergebnisse verfügbar sind.

page_info.start_cursor · String

Der Cursor des ersten Knotens in nodes.

page_info.end_cursor · String

Der Cursor des letzten Knotens in nodes. Verwenden Sie diesen Wert als after-Argument in Ihrer nächsten Query.

Offsetbasierte Pagination (Legacy)

Die offsetbasierte Pagination ist der Legacy-Standard und wird noch von den meisten Listen-Queries verwendet. Sie nutzt page, um eine bestimmte Anzahl von Datensätzen zu überspringen, und size, um ein Ergebnisfenster fester Größe zurückzugeben.

Argumente

size · Integer

Die Anzahl der zurückzugebenden Elemente pro Seite.

page · Integer

Die abzurufende Seitennummer. Lassen Sie dieses Argument weg oder setzen Sie es auf 0, um die erste Seite abzurufen.

Antwort

Die Antwort liefert direkt eine Liste von Datenobjekten, begrenzt durch den Wert von size.

Vielen Dank für Ihr Feedback.

War dieser Inhalt hilfreich?