Pagination

Open

This content is not available in your language yet.

Übersicht

Die LIVOI-API verwendet ein konsistentes Seitenmodell, um große Datenmengen kontrolliert abzurufen. Das page-Objekt steuert dabei eindeutig, welche Ausschnitte einer Datenliste übertragen werden.

page gibt die Zielseite an (beginnend bei 1)
size begrenzt die Elemente pro Seite
Das Offset wird automatisch berechnet
Die Response liefert Paging-Metadaten wie total und has_next

Anfragebeispiel

curl https://api.livoi.de/api/v1/dynamic/query \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "query_model": "user",
  "query_attributes": ["id", "email", "created_at"],
  "page": {
    "page": 1,
    "size": 10
  }
}'

Responseformat

{
  "result": [],
  "page": {
    "page": "1",
    "size": "10",
    "total": "42",
    "has_next": true
  }
}

Bedeutung der Paging-Parameter

page
Die aktuelle Seite der Ergebnismenge.

size
Maximale Anzahl von Einträgen pro Seite.

total

{ "formula": "total_pages = ceil(total / size)" }

has_next

{ "formula": "page * size < total" }

Offset-Berechnung

Offset = (page - 1) * size

Beispiel: page = 3, size = 10 → Offset = 20
Damit werden die Elemente 21–30 zurückgegeben.

Beispielseiten

{
  "page": "1",
  "size": "10",
  "total": "42",
  "has_next": true
}

{
  "page": "2",
  "size": "10",
  "total": "42",
  "has_next": true
}

{
  "page": "5",
  "size": "10",
  "total": "42",
  "has_next": false
}