Pagination

Wie du dich durch große Ergebnismengen der ENLYZE API blätterst.

List-Endpunkte der ENLYZE API geben Ergebnisse seitenweise zurück. Statt alle Datensätze auf einmal zu liefern, liefert die API eine Seite und einen Cursor, mit dem du die nächste Seite abrufst.

So funktioniert die Pagination

Die ENLYZE API nutzt cursorbasierte Pagination. Der Ablauf ist immer gleich:

1. Rufe einen Listen-Endpunkt ohne cursor auf, um die erste Seite zu erhalten.

2. Lies den Wert metadata.next_cursor aus der Antwort.

3. Rufe denselben Endpunkt erneut auf und übergib diesen Wert als cursor-Parameter, um die nächste Seite zu erhalten.

4. Wiederhole Schritt 2 und 3, bis metadata.next_cursor den Wert null hat. Dann sind keine weiteren Daten mehr vorhanden.

Behalte bei Folgeanfragen alle übrigen Parameter (zum Beispiel Filter) unverändert bei. Andernfalls ist der Cursor nicht mehr gültig.

Antwortstruktur

Jede seitenweise Antwort hat dieselbe Struktur:

Feld	Typ	Beschreibung
data	Array	Die Datensätze der aktuellen Seite.
metadata.next_cursor	String oder null	Fortsetzungspunkt für die nächste Seite. null, wenn keine weiteren Daten vorhanden sind.

Für die Anfrage steuerst du die Pagination über einen einzigen Parameter:

Parameter	Ort	Beschreibung
cursor	Query	Startpunkt der abzurufenden Seite. Übergib den Wert aus metadata.next_cursor der vorherigen Antwort. Ohne cursor erhältst du die erste Seite.

Beim Endpunkt POST /v2/timeseries wird der cursor im Anfrage-Body übergeben, nicht als Query-Parameter. Die Antwortstruktur mit data und metadata.next_cursor bleibt identisch.

Beispiel

Erste Seite abrufen:

GET https://app.enlyze.com/api/v2/production-runs

Antwort:

{
  "data": [
    { "uuid": "3f2a…" },
    { "uuid": "8b1c…" }
  ],
  "metadata": {
    "next_cursor": "eyJpZCI6MTQ4fQ"
  }
}

Nächste Seite abrufen, indem du next_cursor als cursor übergibst:

GET https://app.enlyze.com/api/v2/production-runs?cursor=eyJpZCI6MTQ4fQ

Auf der letzten Seite ist next_cursor gleich null:

{
  "data": [
    { "uuid": "d90e…" }
  ],
  "metadata": {
    "next_cursor": null
  }
}

Der Cursor ist ein undurchsichtiges Token. Verändere seinen Inhalt nicht und baue ihn nicht selbst zusammen. Verwende ausschließlich den Wert aus metadata.next_cursor.